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PREFACE 



This reference publication is intended for programmers using the MRX/OS Assembler 
Language. This publication describes how to write assembler source statements, including 
assembler instructions, macro instructions, and conditional assembly statements. These 
instructions are summarized in Appendix E. Machine instructions and extended mnemonic 
codes are summarized in Section 3, and additional reference tables appear in Appendixes B, 
C, and D. The machine instructions are described in detail in the publication 7200 or 7300 
Processing Unit Reference. 
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1. INTRODUCTION 



FUNCTION OF THE ASSEMBLER 

The MRX/OS Assembler consists of a language and an assembler program. The language is a 
set of codes and coding rules for writing a source program. The assembler program translates 
the source program into an object program that can be executed by the system. The object 
program produced by the assembler is in the form of relocatable object modules. This 
translation process is called an assembly. 

Two types of source statements can be expressed in the assembler language, machine 
instructions and assembler instructions. 

The machine instruction source statements provide mnemonic codes for all machine 
instructions in the MRX 40/50 instruction set. Extended mnemonic codes are also provided 
for the skip and branch instructions. Section 3 of this manual describes the general format 
of the machine instructions. A complete description of the machine instructions, addressing 
techniques, and data representation is in the manual 7200 or 7300 Processing Unit 
Reference. 

The assembler instruction source statements specify auxiliary functions to be performed by 
the assembler program. These functions include: 

Checking and documenting programs 

Controlling address assignment 

Segmenting programs 

Defining data and symbols 

Generating macro and form instructions 

Controlling the assembly process through conditional assembly 
statements 

The macro facility enables the programmer to define and use macro instructions. A macro 
instruction is represented by an operation code which, in turn, stands for a sequence of 
statements that accomplish the desired function. 

Conditional assembly statements affect the order of source statement assembly and macro 
generation, or the content of generated statements. 
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A listing of the source program statements and the resulting object program statements may 
be produced with programmer control of form and content. A cross-reference list of symbol 
definitions and references is also produced unless suppressed by the programmer. Errors 
detected during assembly are indicated in the program listing. Warning errors may be 
suppressed. 



RELATIONSHIP TO THE OPERATING SYSTEM 

The assembler program is a component of the MRX 40/50 operating system and operates 
under its control. The operating system provides the assembler program with input/output, 
segment loading, library, and other services needed for its proper functioning. The assembler 
program is called through Control Language statements and resides in a user partition during 
execution. 

SYSTEM REQUIREMENTS 

The MRX 40/50 System equipment configuration required to execute the assembler 
program is as follows. 

• 16K bytes of main storage, of which at least 8K bytes must be 

available to the assembler (additional storage, up to 24K, will 
increase the performance of the assembler) 

One source input device or data set 

One list device or data set 

One operator console 

One 660 disc storage drive 

The standard instruction set 
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2. WRITING SOURCE STATEMENTS 



To write source statements, the programmer should be familiar with the following topics: 

• Character set 

• Basic format of source statements 

• Types of terms and expressions 

• Coding form 

CHARACTER SET 

Source statements may contain the following characters: 



Letters 


A through Z, and $ 


Digits 


through 9 


Special 
Characters 


+ *& 
-(; 
,)" 
. ' blank 



The EBCDIC formats and card punch codes for these characters are listed in Appendix A. 
Any of the 256 punch combinations may appear inside a character constant, in comments, 
or in macro instruction operands. The meanings of these characters, and combinations of 
these characters, are explained in Figure 2-1 . 
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Character 


Explanation 


Example 


A through Z, and $ 


Used in symbols and character string constants 


C ACCOUNT NO.' 


through 9 


Used in numeric constants and symbols 


TAG3.5825 


f 


Operand or suboperand separator 


HERE/THERE 


- 


Indicates a literal tarm or a keyword parameter value 


-A+2 


C 


Defines a character constant (all characters to 
the next apostrophe) 


C'ABC 


X' 


Defines a hexadecimal string constant (all hexa- 
decimal characters to the next apostrophe) 


X'lAFEE' 


P" 


Defines a packed decimal string constant (all 
characters to the next apostrophe) 


P'425' 


z* 


Defines a zoned decimal string constant (all 
characters to the next apostrophe) 


Z'-44' 


V 


Defines an integer string constant (all 
characters to the next apostrophe) 


1*4286* 


cr 


Defines a floating point string constant (all 
characters to the next apostrophe) 


D'147.25E-1' 


it 


Defines a hexadecimal arithmetic constant 


"FF1A 


<> 


Define relational (EQ, GT, LT, NE, LE, GE) 
and logical (NOT, AND, OR, EOR) operations 


A<EQ>B 
A<AND>B 


L' 


Defines a reference to a symbol length attribute 


L'SYMX 


• 


Location counter reference or multiplication 
indicator 


*+4 
12*20 


/ 


Division indicator (Note that 1/2-0 because 
division always results in an integer, not a 
fraction.) 


10/0 
TAG/B 


+ 


Addition indicator 


TAG+12 


- 


Subtraction indicator 


TAB-4 


& 


Defines a variable symbol 


&TAC 


<> 


Separates an address-modifying index from the 
rest of the address, delimits sublisted operands, 
or encloses operands or suboperands 


PAG(R2) 




Used for sequence symbols and concatenation 


.LAST 


* 


Used for macro definition comments 


.•COMMENT 


# 


The character following this symbol is to be 
evaluated for its literal value, not for its special 
function. In the example, the symbol following 
the M sign is a semicolon, not a continuation 
indicator. 


C'24#;4' 


; 


Continuation Indicator 


THE STATEMENT IS; 


@ 


Indirect addressing 


@REG1,@TAG1 


blank 


Field separator 


ADDR 3,4 



Figure 2-1 . Character Usage 
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BASIC FORMAT OF SOURCE STATEMENTS 

Source program statements have the fields outlined in Figure 2-2. 



Name 


Operation 


Operand 


Comment 


Any symbol 
or blank 


Machine instruction, 
assembler instruction, 
macro instruction, or 
FORM instruction 


Single expression, 
several expressions, 
or blank 


Informational material 
or blank 



Figure 2-2. Source Statement Format 



The name field entry is a symbol used to identify a statement. The name field is necessary 
for certain statements, or when the statement is referred to in another statement, such as in 
a Branch instruction. 

The operation field entry is a predefined mnemonic code (or mnemonic) which identifies 
the function of a machine, macro, assembler, or FORM instruction. Mnemonics are designed 
to be easily learned and remembered; for example, ADDR for Add Register-Register, or 
EQU for an Equate assembler instruction. 

The operand field entry defines or identifies the data involved in the operation. Most 
statements have one or more operands, although some statements have no operands at all. 
Each operand has one or more terms, which may be used in a combination to form one or 
more expressions. (Refer to immediately following text for a discussion of terms and 
expressions.) An operand field may not have more than 35 terms. Operands of machine 
statements generally represent storage locations, general registers, immediate data, or 
constant values. Operands of assembler statements provide the information necessary for the 
assembler to perform the designated operation. 

The optional comment field contains any informational material the programmer wishes to 
add. 



TERMS AND EXPRESSIONS 

A term is a symbol, character, or number that represents a value; an expression is a single 
term or a combination of terms. An expression is used in the operand field of a source 
statement. The following text fully defines terms and expressions. 
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TERMS 



Every term represents a value; the value may be assigned by the assembler program (symbol, 
symbol length attribute, location counter reference) or may be inherent in the term itself 
(constant, literal). 

An arithmetic combination of terms is reduced to a single arithmetic value by the assembler. 
An arithmetic value is represented as a 16-bit binary value in two's complement form. A 
logical value has a range of through 65,535; and an arithmetic value has a range of -32,768 
through 32,767. Limitations on the value of an expression depend on its use. For example, a 
term designating a general register must have a value between 0-7 inclusively; a term 
representing an address must not exceed the size of storage. 

A term is absolute if its value does not change upon program relocation. It is relocatable if 
its value changes upon program relocation. 

The terms used in assembler statements are outlined in Figure 2-3. An explanation of each 
type of term and the rules for its use are provided in the following text. 



Constants 



String Constants 



Arithmetic 
Constants 



Character String 
Constant 

Hexadecimal String 
Constant 

Packed Decimal 
String Constant 

Zoned Decimal 
String Constant 

Integer String 
Constant 

Floating Point 
String Constant 

Decimal Arithmetic 
Constant 

Hexadecimal Arithmetic 
Constant 



C'ABC 



X'C49FE' 



P--244' 



Z"246' 



I '-323' 



D'146.3E-1' 



2316 



"2FA 



Symbols 



Location 
Counter 
Reference 

Symbol 
Length 
Attribute 

Literals 



Ordinary Symbols 
Variable Symbols 
Sequence Symbols 

*-20 

L'TABI 
-HERE 



Symbolic Parameter 
System Variable Symbols 
Set Symbols 



&TAB1 

&SYSNDX 

&TAB3 



Figure 2-3. Types of Terms 
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CONSTANTS 

Constants are terms whose values are inherent in the terms themselves. They specify 
machine values or bit configurations directly, rather than by equating the values to symbols 
and then using symbolic references. Constants represent such program elements as 
immediate data, masks, registers, addresses, and address increments. 

Constants are string or arithmetic. String constants are of variable size; arithmetic constants 
are 16 bits long. Examples of all types of constants are presented in Figure 2-6. 



String Constants 

A string constant can only be used as a single term expression, or in a relational expression. 
In a relational expression, both terms must be of the same type (character, hexadecimal, 
etc.), for example: C'ABCE'< LT>C'&P1'. 



Character String Constant 

A character string constant is written as the letter C followed by a character string enclosed 
in apostrophes, for example: C'STRING'. To represent the literal value of an apostrophe, an 
ampersand, a semicolon, or a pound sign as part of the character constant, the character 
must be immediately preceded by an escape character, which is the pound sign. The length 
of a character constant is equal to the number of characters in the constant, excluding the 
escape characters, which do not appear in storage. 

Examples of character constants are shown in Figure 2-4. In the last example of Figure 2-4, 
the generated code is: THIS STRING HAS MANY SPECIAL CHARS IN IT: # ; ' &. 



I0 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 62 63 54 66 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 



_X^AJ&££J>A&£.' 



** 'THIS CHARACTER 3TR1N.6.J . 
JE S . .CQ HTJUUiJLHiL. , . . .^ , ^ . , . , 



£LTJKLA^_£1U£A£££& StBXHlG,* \ I& H6X ££MXiW£ D ' . 



'JZAJLSl 



■STKlNfr HAS MANY £f*£CXAL OVA.RS lit £T.;#s!fetfei 



. i__j i. .... 



*'*$ 



Figure 2-4. Character Constants 
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If the following characters are not preceded by an escape character in a character constant, 
they have the meaning given below: 

Character Meaning 

; A character constant is continued on the next line 

Encloses the characters of a character constant 

& Variable symbol 

# Next character retains its literal value 

Hexadecimal String Constant 

A hexadecimal string constant is written as the letter X followed by a string of hexadecimal 
digits enclosed in apostrophes, such as: X'C49FE'. Each hexadecimal digit is translated into 
its four-bit equivalent. The maximum size of a hexadecimal string constant is limited to the 
maximum number of digits that can be contained on two coding lines. If an odd number of 
digits is specified, the leftmost four bits in the leftmost byte are set to zero. The implied 
length of the constant is half the number of hexadecimal digits in the constant, rounded to 
the next higher integer. 

Packed Decimal String Constant 

A packed decimal string constant is written as the letter P followed by a signed integer 
number enclosed in apostrophes, such as: P'-244'. If the sign is omitted, the number is 
assumed to be positive. Each pair of decimal digits is translated into one byte. The rightmost 
byte of a packed field contains the rightmost digit and the sign. Signs generated are "C16" 
for plus, and "D16" for minus. The maximum length of a packed decimal string constant is 
limited to the number of digits that can be contained on two coding lines. 

Zoned Decimal String Constant 

A zoned decimal string constant is written as the letter Z followed by a signed integer 
number enclosed in apostrophes, for example: Z'246'. If the sign is omitted, the number is 
assumed to be positive. Each decimal digit is translated into one byte. The rightmost byte 
contains the sign and the rightmost digit. Signs generated are "C16" for plus, and "D16" for 
minus. The maximum length of a zoned decimal string constant is limited to the number of 
digits that can be contained on two coding lines. 

Integer String Constant 

An integer string constant is written as the letter I followed by a signed integer number 
enclosed in apostrophes, such as: l'-246'. If the sign is omitted, the number is assumed to be 
positive. An integer string constant is translated into its four-byte binary equivalent. Integer 
constants consist of 1-10 digits with a value ranging from -2^ to 231-1. The constant is 
word aligned when used in a WDD statement or a literal. 
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Floating Point String Constant 

A floating point string constant is written as the letter D followed by a floating point 
number enclosed in apostrophes, such as: D'+2.461E-1". The number is written as a signed 
or unsigned decimal value; if the sign is omitted, the number is assumed to be positive. The 
decimal point may appear before, within, or after the number, or it may be omitted. The 
exponent is optional. It is written immediately after the number in the form Enn, where nn 
is a signed or unsigned decimal integer specifying the exponent of the factor 10. If the 
exponent is unsigned, a plus sign is assumed. 

Alignment can be specified by all data definition statements (WDD, BDD, and FORM). Byte 
alignment is allowed to facilitate building tables containing mixed values with odd 
bounding. Note, however, that all floating point instructions require word bounding of the 
operand in storage. The optional size and repetition factors may be coded. 

The implicit length of a floating point constant is eight bytes, and it is carried as such 
through the assembly. Truncation or padding occurs at object output time with no 
rounding. The floating point decimal value may contain a maximum of 152 digits (including 
the exponent) in addition to the decimal point and sign. The approximate decimal range of 
values allowed is 7.2 X 10 75 to 5.4 X 10" 7 «. 

The internal format of floating point numbers is described in the 7300 Processing Unit 
Reference manual. 
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When string constants define data in storage, truncation and padding of their values is 
performed according to the rules presented in Figure 2-5. 





Explicit Length^ 


Explicit Length > 


Explicit Length < 


Constant 


Implicit Length 


Implicit Length 


Implicit Length 


Character 


C'ABC'(3)=ABC 


Laft justify. 


Left justify. 






Blank fill on right. 


Truncate on right. 


C'ABC' 




C'ABC (4HABC 


Warning message is given. 
C'ABC {2)=AB 


Hexadecimal 


Right justify. 


Right justify. 


Right justify. 




Zero fill on left if the 


Zero fill on left. 


Truncate on left. 


X'lOA' 


constant contains an 




Warning message is given. 




odd number of digits. 


X'10A'<3H)0010A 


X'1OA'(1)=0A 




X'10A'(2)=010A 






Packed 


Right justify. 


Right justify. 


Right justify. 


Decimal 


Zero fill on left if the 


Zero fill on left. 


Truncate on left. 




constant contains even 




Warning mossago is given. 


P*-24* 


number of digits. 
P'-24'(2)=024D 


P'-24'<3>=00024D 


P'-24'(1)=4D 


Zoned 


Z'123'<3)-F1F2C3 


Right justify. 


Right justify. 


Decimal 




Zero fill on left. 


Truncate on left. 
Warning message is given. 


Z'123' 




Z'123' (4I-F0F1F2C3 


F'123M2|=F2C3 


Integer 


Right justify. 


Right justify. 


Right justify. 




Propagate sign on left. 


Propagate sign on left 


Truncate on left. 


l'-758' 






Sign is lost. 




I'-758'(4)=FFFFFD0A 


l'-758'(6)- 
FFFFFFFFFD0A 


Warning message is given. 
I'-758*(1)=0A 


Floating 


Normalize 


Expand fraction. 


Truncate fractional 


Point 


Size « 8 bytes 


Zero fill on right. 


position on right, no 

rounding. 

Warning message is given. 


D"+1.3' 


D'+1.3'= 


D*+1.3(10)= 






4114CCCCCCCCCCCD 


41 14CCCCCCCCCCCD0000 


D'+1.3(4)=4114CCCC j 



Figure 2-5. Truncation and Padding of String Constant Values 



Arithmetic Constants 



Arithmetic constants can be used in multi-term expressions. An arithmetic constant is 
assembled as its two-byte binary equivalent. The maximum size of an arithmetic constant is 
2 1 6-1. |f arithmetic constants are used in statements where an explicit size is specified, 
truncation and padding follow the same rules as those for an integer string constant. 

Decimal Arithmetic Constant 

A decimal arithmetic constant is written as an unsigned integer number of 1-5 digits, for 
example: 20. 
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Hexadecimal Arithmetic Constant 



A hexadecimal arithmetic constant is written as quotation marks followed by a string of 1-4 
hexadecimal digits, for example: "2FA. Each hexadecimal digit is assembled as its four-bit 
binary equivalent. 



Type 


Example 


Generated Hexadecimal Code 


Character String 


CF12AY9*' 

C$Z#'##5' 
C'B' 


C6F1F2C1E8F95C 

5BE97D7BF5 

C2 


Hexadecimal String 


X'C49FE' 

X'F2' 

X*C 


0C49FE 

F2 

0C 


Packed Decimal String 


p-14' 

P'925860' 

P--2' 

P--2596' 


014C 
0925860C 
2D 
02596D 


Zoned Decimal String 


Z'14' 
Z'925860' 
Z/-2' 
Z -2596' 


F1C4 

F9F2F5F8F6C0 
D2 
F2F5F9D6 


Integer String 


l'14* 

C925860' 
l'-2" 
l'-2596' 


00 00 00 0E 
00 0E 20 A4 
FFFFFFFF 
FF FF FS DC 


Floating Point String 


DM0' 

DN-99999999' 

D'-50.25E-1' 


41 A0 00 00 00 00 00 00 
49 25 40 BE 3F FO 00 00 
C1 50 66 66 66 66 66 66 


Decimal Arithmetic 


14 

302 

57399 


000E 
012E 
E037 


Hexadecimal Arithmetic 


"14 

"F2A 

"E09F 


0014 
0F2A 
E09F 



Figure 2-6. Examples of Assembled Constants 



SYMBOLS 

A symbol is a character or combination of characters used to represent locations or arbitrary 
values. Symbols, through their use in name fields and operands, provide the programmer 
with an efficient way to name and reference a program element. A symbol is defined when 
it appears in the name field of a source statement. 
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In general, symbols must conform to these rules: 

1 . The symbol must not have more than eight characters. 

2. The first character must be a letter, a period, a dollar sign, or an 
ampersand (&). 

3. The remaining characters may be digits, letters, or dollar signs. If the 
first character is a period or an ampersand, the second character must 
be a letter or a dollar sign. 

4. The first blank after the start of a symbol terminates that symbol. 

5. Symbol definitions cannot be continued. 

The assembler has three types of symbols: ordinary symbols, variable symbols, and sequence 
symbols. Sequence symbols and variable symbols are used only for the macro language and 
for conditional assembly. 



Ordinary Symbols 

An ordinary symbol consists of 1-8 alphanumeric characters, the first of which must be a 
letter or a dollar sign. Ordinary symbols identify program locations or arbitrary values. The 
value of an ordinary symbol may be absolute or relocatable. Examples of ordinary symbols 
are: 



BETA 

X242 

SENTRYP1 



An ordinary symbol that names an instruction, a storage area, a data definition, or a control 
section is the address of the leftmost byte of the identified field. Address values are 
relocatable terms. The value of an address symbol must not exceed 216-1 . 

An ordinary symbol may be defined only once in an assembly. That is, each symbol used as 
the name of a statement must be unique within that assembly. However, a symbol may be 
used more than once in the name field of a COM or CSECT assembler statement, because 
the coding of a control section may be suspended and then resumed at a subsequent point. 
Some statements require that a symbol in the operand field be previously defined. 

During assembly, the assembler assigns a length attribute to all ordinary symbols. The length 
attribute of a symbol is the length, in bytes, of the storage field whose address is represented 
by the symbol. For example, a symbol naming an instruction that occupies four bytes of 
storage has a length attribute of four. 
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Variable Symbols 

A variable symbol is a symbol that is assigned different values by the programmer or the 
assembler. The three types of variable symbols are: 

1. Symbolic parameters - used only in macro definitions; values are 
assigned by macro instructions. 

2. System variable symbols - used only in macro definitions; values are 
assigned by the assembler. 

3. Set Symbols — used anywhere in the source program; values are 
assigned by SET or GBL statements. 

Variable symbols consist of an ampersand (&) followed by one to seven alphanumeric 
characters, the first of which must be a letter or a dollar sign. Examples of variable symbols 
are: 

&BETA 

&X24 

&P1 



Concatenation of Variable Symbols 

When a variable symbol is assembled, the current value assigned to the variable symbol is 
substituted for the variable symbol. If a variable symbol is immediately preceded or 
followed by other characters or by another variable symbol, concatenation of the variable 
symbol with another variable symbol or character occurs. To concatenate a variable symbol 
with a letter, digit, period, or left parenthesis that follows the symbol, a period must 
immediately follow the variable symbol, for example: &VAL.8. The period merely indicates 
the end of the variable symbol and does not appear in the generated code. The size of a 
concatenated symbol is limited only by the maximum statement size. However, the 
generated symbol is limited by the rules which pertain to the generated name, operation, or 
operand field. See Figure' 2-7 for examples of the concatenation of variable symbols. 

Assume that the following values have been assigned to these variable symbols: 





&P1 = 


= ROP 








&P2 - 


= 5 








&P3 = 


= @ 






Initial Code 






Gei 


nerated Code 


&P1&P2 








R0P5 


&P1.8 








ROP8 


&P3.R7 








@R7 


B.&P2 








B.5 


&P1 








ROP 


703&P2 








7035 



Figure 2-7. Concatenation of Variable Symbols 
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Sequence Symbols 

Sequence symbols consist of a period followed by one to seven alphanumeric characters, the 
first of which must be a letter or a dollar sign. Sequence symbols can be used in the name 
field of any statement except MACRO, GBLA, and GBLC, and in the operand field of only 
ADO or AGO statements. The programmer can use sequence symbols to vary the sequence 
in which statements are processed by the assembler. Examples of sequence symbols are: 

.LAST 
.HERE 

LOCATION COUNTER REFERENCE 

A location counter assigns storage addresses to program statements. It is the assembler's 
equivalent of the instruction counter in the computer. As each machine instruction or data 
area is assembled, the location counter is first adjusted to the proper boundary for the item 
(if adjustment is necessary) and then incremented by the length of the assembled item. 
Thus, it always points to the next available location. If the statement is named by a symbol, 
the value of the symbol is the value of the location counter before addition of the length. 

The assembler maintains a location counter for each control section of the program and 
manipulates each location counter as previously described. Source statements for each 
section are assigned addresses from the location counter for that section. The location 
counter for a given control section assigns locations in storage without regard to assignments 
made within other control sections. 

Thus, if a program has multiple control sections, all statements identified as belonging to the 
first control section will be assigned from the location counter for section 1 ; the statements 
for the second control section will be assigned from the location counter for section 2, etc. 
This procedure is followed whether the statements from different control sections are 
interspersed or written in control section sequence. 

The location counter setting is controlled by using the ORG and ALIGN assembler 
statements. The counter affected by an ORG statement is the counter for the control 
section in which it appears. The maximum value for the location counter is 216-1. 

The programmer can refer to the current location counter by using an asterisk in the 
operand field. The asterisk represents the value of the current location counter at the start 
of the current statement. This value is relocatable. 

An example of the use of the location counter is: 



NAME 




OPERATION 




OPERAND 


12 3 4 5 6 7 8 


9 


10 11 12 13 14 16 16 17 


18 


19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 


GOP 




k/J)J> . 


- 


*,*,* 
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If the location counter is at 0100 when this statement is encountered, the following data is 
generated: 



Location 



Value 



0100 


0100 


0102 


0100 


0104 


0100 



SYMBOL LENGTH ATTRIBUTE 

The length attribute of a symbol may be used as a term by writing L' followed by the 
symbol, for example: L'SYMX. The length attribute of SYMX is then substituted for the 
term. The length attribute of an ordinary symbol is the length, in bytes, of the storage field 
whose address is represented by the symbol. 

The length attribute of * is invalid. If the operand of an EQU statement is an asterisk or an 
arithmetic constant, the symbol defined by the EQU statement has a length attribute of 
one. In any other context, the length attribute of an arithmetic constant is two. Examples 
of symbol length attributes are shown in Figure 2-8. 



12 3 4 5 6 7 



mm 



10 11 12 13 14 15 16 17 






MJiMl 



LOG 



VtWL 

CARITM 



E4U 

1 CARXTH 

kOJBJ) 



H O0M> IMSif ftUCXIQH lO? MTLS Xomt 



CQ&L 



* LVCMS 

INT t 



E.QU 



Mil ^ 
II CELEV 



•i CXNTTEGEk 



19 20 21 22 23 24 25.26 27 28 29 30, 31 32. 33 34 35 36 37 38 39 40.41 42 43 44 45,46 47 48 49 50, 



61 
dON-sfANTV 



Z5$*ISJ /7/Y .7 .Y_^-uI^^ _^^.-l. 
CONSTANT IN 1M STATE/lENT) . 

XR.JU 



CLocAfioti ctr Kef T£ sM^fAiuiEMry 



C ' THIS .ATRIHGA.^ ^^ - v 
N CHARA.GTEAS. IN STAING.) 



STRING IS X SUTZSTlMbX 



Figure 2-8. Examples of Length Attributes 
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Bulletin: 2202.001-0101 
Date: 3/19/73 

LITERALS 

A literal term is used to introduce data into a program. The formats of a literal term are as 

follows. 

Where: 

=a a is the data value to be generated (required); any legal expression 

except another literal term. 

=a(b,c) b is the length specification (in bytes): a positive absolute expres- 
sion. If omitted, the length specification is the implied size of 
=a(b) the expression. 

c is the repetition factor; a positive absolute expression. If omitted, 
a repetition of 1 is assumed. If the size or length is specified 
symbolically, the symbol must have been previously defined. 



=a(,c) 



Examples of literals are shown in Figure 2-9. 



—CABD' Invalid: literal cannot define another literal. 

=C'ABD'(4,3) Valid: same as =C'ABD ABD ABD' 

=A+B/2+4 Valid: implied length is the length of symbol A; implied 

repetition factor is 1 . 

=P'-446'(6) Valid: specified length is 6; implied repetition factor is 1. 

=X'FF00'(,3) Valid: implied length is 2; specified repetition factor is 3. 

Figure 2-9. Examples of Literals 



The assembler generates the literal data, stores this data in a literal pool, and places the 
address of the stored data in the operand field of the statement using the literal. The 
position of the literal pool may be controlled by the programmer with the LTORG 
assembler statement. If LTORG is not specified at the end of a control section, the literal 
pool for that segment is placed at the end of the first control section. 

A literal can be defined at any point in a program by specifying the literal in the operand of 
the statement in which it is used. In contrast, data definition statements define and label 
data, and then the label is used to specify the data. 

A literal may not be combined with any other term, nor may a literal be used as a receiving 
field of a statement that modifies storage. 

Literals are relocatable, because the address of the literal, not the literal itself, is assembled 
into the statement using the literal. 
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If duplicate literals are specified within one literal pool, only one literal is stored. Literals 
are duplicate if their final specifications, size, and repetition factors are identical on a 
character-by-character basis. A literal may be a duplicate even when it appears to be 
different (see examples in Figure 2-10). A literal is a duplicate if it contains no forward 
references and the expressions evaluate to the same value as the corresponding expressions 
of an existing literal. 

A literal which contains a reference to the location counter is stored even if it duplicates 
another literal (see examples). If an expression used in a literal term contains a forward 
reference to a symbol, the symbol is assumed to represent a two-byte value. 



Examples of duplicate literals are shown in Figure 2-10. 



=CABC'(4 # 3) 
■=C'ABC'(4,3) 

=C'ABC 
=X'C1C2C3' 

=A+B 
=B+A 

=C<EQ>D 
=1 

=*+10 
-=*+10 



Only one literal is stored. 



Both literals are stored. 



Only one literal is stored if A and B are predefined symbols. 



Only one literal is stored if C is defined to be equal to D, so that the 
expression is equal to 1 . 

Both literals are stored 



Figure 2-10. Examples of Duplicate Literals 



EXPRESSIONS 

An expression is defined as one or more terms linked by arithmetic, relational, or logical 
operators. Expressions may be single term or multi-term (see examples below). 



Single Term Expressions 

29 

"F0 

SYMX 



L'SYMX 
P'-240' 



Multi-Term Expressions 

SYMX+40 

A+B/2+10 

(X<OR>"F0F0)<EQ>(SP2<OR>"F0F0) 

(((A+4)/2+1)*2<AND>"00FF)<EQ>24) 

*+L'BETA 

A+B<LE>SUM 
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During assembly, all expressions are resolved to a single value. Figure 2-11 provides an 
explanation of all types of operators. 

The rules for coding expressions within an operand field are as follows. 

1. An expression may not start with an arithmetic, relational, or logical 
operator. However, an expression may begin with a unary operator: 
positive sign (+), negative sign (-), or logical complement (< NOT>). 
A unary operator indicates the state of the numbers it precedes (such 
as negative, positive, or complement), rather than indicating an 
arithmetic operation (such as addition or subtraction). 

2. An expression may not contain two terms in succession. 

3. An expression may not contain two operators in succession, except 
for the logical operator < NOT>, which may follow the logical 
operators < AN D>, <OR>,and <EOR>. 

4. A multi-term expression may not contain a literal. 

5. In a multi-term expression, string constants are restricted to 
relational operations. 



EVALUATION OF EXPRESSIONS 

A single term expression has the value of the term involved. 

A multi-term expression is reduced to a single arithmetic value as follows. 

1 . Each term is given its value. 

2. Operations are performed from left to right using the following rules 
of precedence: 

a. Unary arithmetic operations: positive (+) and negative (-). 

b. Arithmetic multiplication (*) and division (/). 

c. Arithmetic addition (+) and subtraction (-). 

d. Relational operations (<EQ>, <NE>, <LT>, <GT>, 
<LE>,and <GE>). 

e. Unary logical complement ( < NOT > ). 

f. Logical product (< AND >). 

g. Logical addition (<OR>) and subtraction (<EOR >). 
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The expression is computed to 32 bits, and then truncated to 16 bits 
or less, depending on its contextual use. 

Division always yields an integer result. For example, 1/2*10 yields a 
zero result, whereas 10*1/2 yields 5. Division by zero is permitted 
and yields a zero result. 

A relational operation yields a binary result of or 1. If string 
constants are used in relational operations, both relational terms 
must be of the same type; thus, P'246'<EQ>Z'246' is illegal. 

Logical operations are performed on a bit-by-bit basis equivalent to a 
masking operation. A non-zero value is considered true and a zero 
value is considered false. 



Arithmetic Operators 


Operator 


Meaning 


Example 


+ 


Addition 


A+B 


- 


Subtraction 


10-C 


* 


Multiplication 


D*16 


/ 


Division 


25/X 


Relational Operators 


Operator 


Meaning 


Example 


<EQ> 


Equal to 


A<EQ>B 


<NE> 


Not equal to 


A<NE>B 


<LT> 


Less than 


17<LT>&P1 


<GT> 


Greater than 


69<GT>TAB 


<LE> 


Less than or equal to 


73<LE>M 


<GE> 


Greater than or equal to 


"3F<GE>&TAB1 


Logical Operators 


Operator 


Meaning 


Example 


<NOT> 


Logical complement (one's 
complement) 


<NOT>A 


<AND> 


Logical product 


A<AND>B 


<OR> 


Logical addition (inclusive or) 


A<OR>B 


<EOR> 


Logical subtraction (exclusive or) 


A<EOR>W 



Figure 2-1 1 . Types of Operators 
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Parentheses are used in the normal role of arithmetic grouping to change the order of 
evaluation. Parenthesized parts of an expression are evaluated before the rest of the terms in 
the expression. In the case of nested parentheses, the innermost parentheses are evaluated 
first. For example, the expression ((A+4)fc+1)*B is evaluated as follows, if A=10 and B=3. 

1. A+4 = 14 giving (14/2+1 )*B 

2. 14/2 = 7 giving, (7+1 )*B 

3. 7+1 = 8 giving 8*B 

4. 8*B = 24 giving 24 



ABSOLUTE AND RELOCATAEJLE EXPRESSIONS 

An expression is absolute if its value is unaffected by program relocation. It is relocatable if 
its value is changed by program relocation. 



Absolute Expressions 

An absolute expression may contain relocatable terms (RT) alone, or in combination with 
absolute terms (AT), provided the following conditions are met. 



1. The relocatable terms must be paired or used in a relational 
operation. The terms in a pair must have opposite signs, but do not 
have to be contiguous, as in the example: RT+AT-RT. Each pair 
must be relocated to the same location counter. 

2. A relocatable term or expression must not enter into a 
multiplication, division, or logical operation. For example: 
RT-RT*10 is invalid, while (RT-RT)*10 is valid. 

3. The result of a relational operation is absolute regardless of the 
relocatability of the terms or expressions used in the operation. 

4. Relocatable terms or expressions used in a relational operation are 
considered absolute. The relocatability attribute is disregarded. Thus 
RT<LT>RT is valid even if the two terms or expressions do not 
appear in the same control section. 

5. If an expression that enters into a relational operation has multiple 
relocation attributes, an error indicator is given and the operation is 
performed as if the value of the expression were absolute, for 
example: RT<EQ>RTi+RT2- 
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Relocatable Expressions 

A relocatable expression reduces to a single relocatable value. A relocatable expression may 
contain relocatable terms alone, or in combination with absolute terms, provided the 
following conditions are met. 

1. All the relocatable terms but one must be paired, or be involved in a 
relational operation. 

2. The leftover relocatable term must not be directly preceded by a 
minus sign. 

3. No relocatable term may enter into a multiplication, division, or 
logical operation. 



Examples of Absolute and Relocatable Expressions 

The following examples illustrate absolute and relocatable expressions. A is an absolute 
term; BR1 and CR1 are relocatable terms within the current control section. XR2 is a 
relocatable term in a control section different from that in which BR1 and CR1 are defined. 
Examples of absolute and relocatable expressions are: 



Absolute Expressions Relocatable Expressions 

A-BR1+CR1 A*A+BR1+XR2-CR1 

A BR1 

BR1+A-CR1 BR1+CR1-* 

BR1+(XR2<LT>CR1)+A-CR1 (BR1 <EQ>XR2)*10+CR1 

CODING FORM 

Figure 2-12 illustrates a source code form provided for convenience to the programmer and 
the keypunch operator. Since assembler statements are free form, the various fields (name, 
operation, operand, and comment) need not begin in any specified column. The only 
restrictions are that the fields appear in the sequence shown, be separated by one or more 
spaces, and the name field begin in column 1. If the name field is omitted, the operation 
field can begin in any column after column 1. 

All statements are contained in columns 1 through 72. Columns 73 through 80 are reserved 
for identification and statement sequencing. Thus, column 1 is called the begin column and 
column 72 the end column. The standard begin and end columns can, however, be altered 
by the ICTL assembler statement. (This statement is described in Chapter 6. Program 
Control Statements.) 
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EMDIMM Assembler Coding Form 



Punching Instructions 



Paa e of 



Graphic 



Punch 



Programmer_ 
Program 



NAME 


OPERATION 




OPERAND 


IDENTIFICATION 


12 3 4 5 6 7 8 9 


10 11 12 13 14 15 1G 17 


18 


19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55.56 57 58 59 60 61 62 63 64 65 66 67 68 69.70.71 72 


73 74 75 76 77 78 79 80 
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73 74 75 76 77 78 79 80 



NAME FIELD 

If the name field is included, it must begin in the begin column (column 1). If the name 
field is omitted, the begin column must be blank. A name cannot be more than eight 
characters long after substitution, and cannot be continued on the next line. 



OPERATION FIELD 

The operation field begins after the first blank column. More than one blank column can 
separate the name field and the operation field; however, within the operation field, blanks 
are not allowed. The operation field after substitution cannot be more than eight characters. 
It cannot be continued. 



OPERAND FIELD 

Operands identify or describe data used in a statement. An operand may be actual data, a 
storage address, a register number, a field length, mask, etc. A comma must separate 
operands; embedded blanks or spaces are not allowed, except in strings. 



COMMENT FIELD 

To include comments on the same line as an existing statement, the programmer must begin 
the comment at least one space after the operand field. A comment cannot extend past the 
end column (column 72). An asterisk (*) or a period and asterisk (.*) starting in the begin 
column indicate a comment statement. The asterisk is used for commentary notes on the 
source program; the period and asterisk are used for comments in a macro definition. 
Comments do not affect the assembled program, but are printed in the assembly listing. 

The following example illustrates the name, operation, operand, and comment fields. LOAD 
REGISTER on the first line is a comment because a space separates it from the last operand. 
The asterisk on the second line in column 1 specifies that all characters on that line are 

comments. 



NAME 




OPERATION 




OPERAND 


12 3 4 5 6 7 8 


9 


10 11 12 13 14 15 16 17 


18 


19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 


BEGIN 

* _ 




kOD 




TAG. 1 LOAD REGISTER ^ 

1 PROM T^G ._. 





IDENTIFICATION-SEQUENCE FIELD 

The identification-sequence field is used for identification or sequencing of statements. This 
optional field is normally contained in positions 73-80. The contents of the field appear in 
the source listing. The programmer may verify the statement sequence by the use of the 
ISEQ assembler statement (discussed in Chapter 6). 
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STATEMENT CONTINUATION 

A semicolon (;) indicates that a statement is continued to the next line. The first non-blank 
character in the next line is the start of the continuation line. Therefore, a blank cannot be 
the first character of a continuation line. Only one continuation line is allowed for source 
statements, except for macro instructions, prototype statements, and GBL statements. Any 
characters after a semicolon are ignored by the assembler and considered as comments. A 
semicolon preceded by an escape character retains its literal value. The first non-blank 
character of a continuation line cannot be a semicolon; nor can a continuation line be 
entirely blank. 

The operands in the following example are two character constants: ACCOUNT; and 
TOTAL EQUALS THE FOLLOWING. The first semicolon retains its literal value because it 
is preceded by an escape character. The second semicolon indicates to the assembler that the 
second operand is continued on the next line beginning with the first non-blank character. 
HEADINGS, which appears after the semicolon, is a comment. Note that the blank between 
TOTAL and EQUALS must be coded on the first line, not in the continuation line. 



NAME 




OPERATION 




OPERAND 


12 3 4 5 6 7 8 


9 


10 11 12 13 14 IB 16 17 


18 


19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45,46 47 48 49 50, 


BEGIN 




WDD 




C ACCOUNTS :».C« TOTAL JifMDIMGSu 

EQUALS THE FOLLOWING: A , 
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3. MACHINE INSTRUCTIONS 



SOURCE STATEMENTS 

Machine instruction source statements consist of: 

• Name field (optional) 

• Mnemonic operation code 

• Operand field 

• Comment field (optional) 

An example of a machine instruction source statement is given below. (The data flow of 
most machine instructions is operand Woperand 2.) 



NAME 

1 I 3 4 b b ! 8 


9 


OPERATION 




OPERAND 


10 11 12 13 14 15 IC 17 


18 


19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 


NAMU 




UOJ) 




ArtOUNTOU) ,JU THIS SETS UP. RZ . 



INSTRUCTION ALIGNMENT AND CHECKING 

All machine instructions are aligned by the assembler on even-byte boundaries. The 
assembler advances the current location counter the amount necessary to ensure correct 
alignment of the assembled instructions. The contents of the area between the prealignment 
location counter and the postalignment location counter is unchanged. All expressions that 
specify storage addresses are checked to ensure appropriate alignment for the instruction 
format in which they are used. 



OPERANDS AND SUBOPERANDS 

Machine instructions have 0, 1, or 2 operands. Operands are written as a single operand, or 
as an operand with 1 or 2 suboperands. The possible formats of an operand are shown 
below. 

op 

op(subop) 

op(,subop) 

op(subop,subop) 
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Operands specify immediate values, memory locations, or general register numbers, while 
suboperands specify explicit lengths or index registers. 

If indexing is not desired for an instruction, the suboperand used for indexing is omitted. 
General register zero cannot be used by machine instructions as an index. Its specification as 
an index is flagged as an error. 

The at-sign (@) in the first character position of an operand specifies indirect addressing of a 
memory address or general register, as in the following example. 



NAME 




OPERATION 




OPERAND 


12 3 4 6 6 7 8 


9 


10 11 12 13 14 16 16 17 


18 


19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 4546 47 48 49 50, 






LOJ5 




@>/U*MES.CWLGJ.y,@RE.GA 



NAME AND LENGTH ATTRIBUTES 

Any machine instruction statement may be named by a symbol, to which other assembler 
statements can refer. The value attribute of the symbol is the address of the leftmost byte 
assigned to the assembled instruction. 

The length attribute may be 2, 4, 6, or 8, depending upon how many bytes are used for an 
instruction. 

The length field of 6 or 8 byte instruction formats can be explicit or implied. To imply a 
length, the length suboperand is omitted. The omission indicates that the length field is 
either the length attribute of the expression specifying the effective address, or the length of 
the literal. 

The length attribute of an expression is the length attribute of the leftmost (or only) term in 
the expression. 



NOTATION USED TO DESCRIBE MACHINE INSTRUCTIONS 

The source formats of the operands are defined using the following symbols. 

Op Code The operation codes are presented in hexadecimal (00 through FF). 

R Absolute expression specifying a general register number, 0-7. The register 

may be used as a sending or receiving field (0-7), or as an index register 
(1-7 only). 

E Absolute expression specifying an extended register, 0-15 (for RDX and 

WRXonly). 

M Absolute or relocatable expression that specifies a memory address, 

0-65,535. 
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I An absolute expression specifying an immediate value; the value varies 

depending on the instruction. The value may represent an amount used in 
an arithmetic operation, a shift count, a skip count, or a bit number. 

L Absolute expression specifying a field length, usually 0-255, but longer for 

some instructions. For certain instructions the length of an operand field 
may be defined in the instruction. The length specified in the instruction 
overrides any previous field length definition, but is only in effect for that 
instruction. 

@ An at-sign (@) in a source operand indicates indirect addressing, an 

optional feature. For the instructions in which a register is a sending or 
receiving field, the at-sign indicates indirect addressing for Ri or R2- If a 
field in memory is the sending or receiving field, the at-sign indicates 
indirect addressing of Mi or M2- 

( ) Index registers and field lengths are optional; they are enclosed in 

parentheses in a source operand. A source operand using both an indexing 
and a field length specification would be represented like this: 
Mi (l_i,Ri). The comma in the parentheses must not only be coded when 
both the length and index register are used, but also if the second operand 
is used, as follows: Mi(l_i) or Mi(,Ri). This enables the assembler to 
distinguish between the two specifications in parentheses. 

• A bullet following a mnemonic indicates the operands are 

byte-addressable; all other operands are word-addressable only. 

An R, M, I, or L in source operand 1 is identified as R-], Mi, If, or l_i; in source operand 2 
they are identified as R2, M2, 12, or l_2. 

The two major operand fields must be separated by a comma; no blanks are allowed 
anywhere in the operand fields. 

Remember that the at-sign and any designations in parentheses (field length and index 
registers) are almost always optional; if any of these designations are not optional, this fact 
will be noted. Data flow is usually operand 1 to operand 2, unless stated otherwise. 



SUMMARY OF MACHINE INSTRUCTIONS 

The MRX 40/50 System machine instruction set is divided into two major categories: 
General-Purpose instructions and System instructions. General-purpose instructions are the 
instructions needed to solve most data processing problems using a defined software system. 
System instructions are specialized instructions used to interpret and alter a software 
system. 
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The General-Purpose instructions may be used at any time; the System instructions require 
certain preconditions and cautions. For information on using the System instructions refer 
to the publication 7200 or 7300 Processing Unit Reference. 

Within these two major categories, the instructions are divided into functional groups, and 
these functional groups are listed in alphabetical order, as shown in the following table. 

General Purpose Instructi ons System Instructions 

Arithmetic Control 

Bit-Oriented I/O 

Boolean Logic 

Branching 

Compare 

Control 

Data Conversion 

Data Transfer 

Shift 

Optional: Floatingpoint 

The instructions in each functional group are listed alphabetically by mnemonic. This rule 
holds for all instructions except for logical pairs or groups of instructions - these 
instructions are listed alphabetically according to the first instruction of the pair. For 
instance, PAKX (Pack) will be followed by UNPX (Unpack), and SB (Skip Back 
Unconditional) will be followed by SF (Skip Forward Unconditional). 
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GENERAL-PURPOSE INSTRUCTIONS 



Arithmetic 




Mnemonic 


Name 


ADD 


Add Memory-Register 


ADDD 


Add Direct 


ADDI 


Add Immediate 


ADDK 


Added Packed Decimal • 


ADDM 


Add Memory-Memory 


ADDR 


Add Register-Register 


ADDT 


Add Two-Word 


DIV 


Divide Memory-Register 


DIVD 


Divide Direct 


DIVK 


Divide Packed Decimal • 


DIVI 


Divide Immediate 


DIVM 


Divide Memory-Memory 


DIVR 


Divide Register-Register 


MPY 


Multiply Memory-Register 


MPYD 


Multiply Direct 


MPYI 


Multiply Immediate 


MPYK 


Multiply Packed Decimal • 


MPYM 


Multiply Memory-Memory 


MPYR 


Multiply Register-Register 


SUB 


Subtract Memory-Register 


SUBD 


Subtract Direct 


SUBI 


Subtract Immediate 


SUBK 


Subtract Packed Decimal • 


SUBM 


Subtract Memory-Memory 


SUBR 


Subtract Register-Register 


SUBT 


Subtract Two-word 


ZADK 


Zero and Add Decimal • 



Code 


Lqth 


Operands 


A2 


4 


@M 1 (R 1 ),@R 2 


B2 


4 


ll(R-|),@R2 


32 


2 


l-|,@R 2 


52 


8 


M 1 (L 1 ,R 1 ),M 2 (L2,R 2 ) 


62 


6 


@M 1 (Ri),@M 2 (R 2 ) 


22 


2 


@R 1 ,@R 2 


72 


4 


@M-,(Ri),@R 2 


A9 


4 


@M 1 (R 1 ),@R 2 


B9 


4 


l-|(R 1 ),@R 2 


7C 


8 


M 1 (Li,Ri),M 2 (L 2 ,R 2 ) 


39 


2 


l 1 ,@R 2 


69 


6 


@M 1 (R 1 ),@M 2 (R 2 ) 


29 


2 


@R 1( @R 2 


A8 


4 


@M 1 (R 1 ),@R 2 


B8 


4 


h (R-, ),@R 2 


38 


2 


l-|,@R 2 


5B 


8 


M 1 (L 1 ,R 1 ),M 2 (L 2 ,R2) 


68 


6 


@M 1 (R 1 ),@M 2 (R 2 ) 


28 


2 


@R 1 ,@R 2 


A3 


4 


@M 1 (R 1 ),@R 2 


B3 


4 


l 1 (R 1 ),@R 2 


33 


2 


ll,@R 2 


53 


8 


M 1 (L 1 ,R 1 ),M 2 (L 2 ,R 2 ) 


63 


6 


@M 1 (R 1 ),@M 2 (R 2 ) 


23 


2 


@R 1# @R 2 


73 


4 • 


@M 1 (R 1 ),@R 2 


50 


8 


M 1 (L 1 ,R 1 ),M 9 (L9,R9) 



Bit-Oriented Instructions 



IBIT 


Invert Bit • 


ROFR 


Reverse Off-Bit 


RONR 


Reverse On-Bit 


SBIT 


Set Bit o 


RBIT 


Reset Bit • 


TBIT 


Test Bit • 


TOFR 


Test for Off-Bit 


TONR 


Test for On-Bit 



BF 


4 


@Mi{R.|),l2 


6F 


2 


@R 1 ,@R 2 


6D 


2 


@Rl,@R 2 


BC 


4 


@Mi(R-|),l 2 


BD 


4 


@M- i [R- i ),\ 2 


BE 


4 


@M.|(R.|),l2 


6E 


2 


@R 1r @R 2 


6C 


2 


@R-|,@R 2 



Boolean Logic Instructions 



AND 
ANDD 



Logical Product Memory-Register 
Logical Product Direct 



A5 
B5 



4 

4 



@M 1 (R-|),@R 2 
ll(R-l),@R 2 
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Boolean Logic Instructions (Continued) 



Mnemonic 


Name 


ANDI 


Logical Product Immediate 


ANDM 


Logical Product Memory-Memory 


ANDR 


Logical Product Register-Register 


EOR 


Exclusive OR Memory-Register 


EORD 


Exclusive OR Direct 


EORI 


Exclusive OR Immediate 


EORM 


Exclusive OR Memory-Memory 


EORR 


Exclusive OR Register-Register 


IOR 


Inclusive OR Memory-Register 


IORD 


Inclusive OR Direct 


IORI 


Inclusive OR Immediate 


IORM 


Inclusive OR Memory-Memory 


IORR 


Inclusive OR Register-Register 


Branching 


Instructions 


B 


Branch (post-indexing) 


BA1 


Branch Add One 


BA2 


Branch Add Two 


BCF 


Branch on Condition Register False 


BCT 


Branch on Condition Register True 


BCH 


Branch Uncond. (pre-indexing) 


BOF 


Branch if Bit Off 


BON 


Branch if Bit On 


BR 


Branch to Address in Register 


BRN 


Branch if Register is Not Zero 


BRZ 


Branch if Register is Zero 


BS1 


Branch Subtract One 


BS2 


Branch Subtract Two 


BSR 


Branch and Save Return 


SB 


Skip Back - Uncond. 


SF 


Skip Forward - Uncond. 


SCFB 


Skip on Condition False - Back 


SCFF 


Skip on Condition False - Forward 


SCTB 


Skip on Condition True - Back 


SCTF 


Skip on Condition True - Forward 


SRMB 


Skip if Reg. Minus - Back 


SRMF 


Skip if Reg. Minus - Forward 


SRPB 


Skip if Reg. Plus - Back 


SRPF 


Skip if Reg. Plus - Forward 


SRNB 


Skip if Reg. Not Zero - Back 


SRNF 


Skip if Reg. Not Zero - Forward 


SRZB 


Skip if Reg. Zero - Back 


SRZF 


Skip if Reg. Zero - Forward 



Code Lgth Operands 



35 


2 


ll,@R 2 


65 


6 


@Mi(R 1 ),@M 2 (R2) 


25 


2 


@Rl,@R 2 


A6 


4 


@M 1 (Ri),@R 2 


B6 


4 


l-|(R 1 ),@R 2 


36 


2 


l 1 ,@R 2 


66 


6 


@M 1 (R 1 ),@M 2 (R 2 


26 


2 


@R-|,@R 2 


A7 


4 


@Mi(R 1 ),@R 2 


B7 


4 


l 1 (R 1 ),@R 2 


37 


2 


l 1 ,@R 2 


67 


6 


@M 1 (Ri),@M 2 (R 2 


27 


2 


@R 1r @R 2 



ED 


4 


@Mi(Ri> 


E4 


4 


@M-|(R-|),@R 2 


E5 


4 


@M 1 (R-|),@R 2 


E9 


4 


©M^R^,^ 


E8 


4 


SW^Rt),^ 


EC 


4 


©M^R,) 


E2 


4 


@M^Rl),\ 2 


E3 


4 


@Mi[n^).\ 2 


EB 


2 


@R-| 


E1 


4 


@M 1 (R 1 ),@R 2 


EO 


4 


@M 1 (Ri),@R 2 


E6 


4 


@M 1 (R 1 ),@R 2 


E7 


4 


@M 1 (R 1 ),@R 2 


EA 


4 


@M 1 (R 1 ),@R 2 


BB 


2 


»1 


BA 


2 


'1 


4B 


2 


'1.'2 


49 


2 


■l.'2 


4A 


2 


«1.'2 


48 


2 


■ l.l 2 


47 


2 


l 1f R 2 


46 


2 


l 1f R 2 


45 


2 


I V R 2 


44 


2 


'1-R2 


43 


2 


h,R 2 


42 


2 


'1-R2 


41 


2 


'1.R2 


40 


2 


'1- R 2 
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Compare Instructions 



Mnemonic 


Name 


Code 


Lgth 


Operands 


CBY 


Compare Byte Memory- Register • 


F9 


4 


@M 1 (R 1 ),@R 2 


CBYM 


Compare Byte Memory-Memory • 


6B 


6 


@M 1 (R 1 ),@M 2 (R2) 


CMP 


Compare Memory-Register 


A1 


4 


@M-|(R 1 ),@R 2 


CMPD 


Compare Direct 


B1 


4 


ll(Rl),@R 2 


CM PI 


Compare Immediate 


31 


2 


l 1 ,@R 2 


CMPK 


Compare Packed Decimal • 


51 


8 


Mi(Li,R 1 ),M 2 (L 2 ,R2> 


CMPM 


Compare Memory-Memory 


61 


6 


@M-|(Ri>,@M 2 (R 2 ) 


CMPR 


Compare Register-Register 


21 


2 


@R 1 ,@R 2 


CMPT 


Compare Two-Word 


71 


4 


@Mi(R 1 ),@R 2 


CMPX 


Compare Characters • 


55 


8 


M 1 (L 1 ,R 1 ),M 2 (L 2 ,R 2 ) 



Control Instructions 

General Purpose Control instructions can be used at any time without preconditions; compare with System 
Control instructions. 



NOP 


No Operation 


RDX 


Read Extended Register 


SR 


Service Request 



EE 4 Blank or @M 1 (R 1 ),R 2 

FO 2 E 1f R 2 

13 2 @l-, 



Data Conversion Instructions 



CVB 


Convert to Binary • 


AA 


4 


@M.|(R 1 ),R 2 


CVBT 


Convert to Binary Two-Word • 


AA 


4 


@M 1 (R 1 ),R 2 


CVD 


Convert to Decimal • 


AB 


4 


@Mi(R 1 ),R 2 


CVDT 


Convert to Decimal Two-Word • 


AB 


4 


@M 1 (R 1 ),R 2 


EDTX 


Packed Decimal/Alpha Edit • 


57 


8 


M 1 (L 1 ,R 1 ),M 2 (L 2 ,R 2 ) 


PAKX 


Pack* 


58 


8 


M 1 (Li,Ri),M 2 (L 2 ,R 2 ) 


UNPX 


Unpack • 


59 


8 


M 1 (L 1 ,R 1 ),M 2 (L 2 ,R 2 ) 


TRNX 


Translate • 


56 


8 


M 1 (R 1 ),M 2 (L 2 ,R 2 ) 



Data Transfer Instructions 



CLDR 


Condition Register Load 


2B 


2 


@Rl 


CSTR 


Condition Register Store 


2A 


2 


@Rt 


INV 


Inverse Move Memory-Register 


A4 


4 


@M 1 (R 1 ),@R 2 


INVD 


Inverse Move Direct 


B4 


4 


l 1 (R 1 ),@R 2 


INVI 


Inverse Move Immediate 


34 


2 


ll,@R 2 


INVM 


Inverse Move Memory-Memory 


64 


6 


@M 1 (R 1 ),@M 2 (R 2 ) 


INVR 


Inverse Move Register-Register 


24 


2 


@R-|,@R 2 


LOD 


Load Memory- Register 


AO 


4 


@M 1 (R 1 ),@R 2 


LODB 


Load Byte • 


F7 


4 


@M 1 (R 1 ),@R 2 


LODD 


Load Direct 


BO 


4 


l 1 (Rl),@R 2 


LODI 


Load Immediate 


30 


2 


l 1( @R 2 


LOOT 


Load Two-Word 


70 


4 


@M-|(R 1 ),@R 2 


MOVB 


Move Byte • 


6A 


6 


@M 1 (R 1 ),@M 2 (R 2 ) 
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Data Transfer Instructions (Continued) 



Mnemonic 


Name 


MOVL 


Move Long • 


MOVM 


Move Memory-Memory 


MOVR 


Move Register-Register 


MOVX 


Move Characters • 


PSTR 


Program Address Store 


STO 


Store Memory- Register 


STOB 


Store Byte • 


STOT 


Store Two-Word 


Shift Instructions 



Code Lgth Operands 



5A 


8 


M 1 (L 1 ,R 1 ),M 2 (R2> 


60 


6 


@M 1 (R 1 ),@M 2 (R2> 


20 


2 


@Rl,@R 2 


54 


8 


M 1 (L 1 ,R 1 ),M 2 (L 2 ,R2) 


3A 


2 


@R! 


FA 


4 


@M 1 (R 1 ),@R 2 


F8 


4 


@M 1 (R 1 ),@R 2 


FB 


4 


@M 1 (R 1 ),@R 2 



ARDI 

ARDR 

ARSI 

ARSR 

LLDI 

LLDR 

LLSI 

LLSR 

LRDI 

LRDR 

LRSI 

LRSR 

RLDI 

RLDR 

RLSI 

RLSR 

SHFK 



Arithmetic Right Double Shift - 

Immediate 

Arithmetic Right Double Shift - 

By Register 

Arithmetic Right Single Shift - 

Immediate 

Arithmetic Right Single Shift - 

By Register 

Logical Left Double Shift - Immediate 

Logical Left Double Shift - By Register 

Logical Left Single Shift - Immediate 

Logical Left Single Shift - By Register 

Logical Right Double Shift - Immediate 

Logical Right Double Shift - By Register 

Logical Right Single Shift - Immediate 

Logical Right Single Shift - By Register 

Rotating Left Double Shift - 

Immediate 

Rotating Left Double Shift - 

By Register 

Rotating Left Single Shift - Immediate 

Rotating Left Single Shift - By Register 

Shift Packed Decimal • 



5F 


2 


l 1r R 2 


3F 


2 


@R-|,R 2 


4F 


2 


'1- R 2 


2F 


2 


@Rl,R 2 


5C 


2 


»1.*2 


3C 


2 


@R-|,R 2 


4C 


2 


l lf R 2 


2C 


2 


@R-|,R 2 


5D 


2 


'1< R 2 


3D 


2 


@R 1 ,R 2 


4D 


2 


'1.*2 


2D 


2 


@R-|,R 2 


5E 


2 


l 1# R 2 



3E 2 @R V R 2 

4E 2 li,R 2 

2E 2 @Ri,R 2 

3B 6 M 1 (L 1 ,R 1 ).I 2 ( R 2> 



Floating Point Instructions (Optional) 



ADDF 

CMPF 

DIVF 

FLT 

FLTT 

INT 

I NTT 

LODF 
MPYF 
NEGF 



Add Floating Point 

Compare Floating Point 

Divide Floating Point 

Convert Fixed to Float 

Convert Fixed to Float Two Word 

Convert Float to Fixed 

Convert Float to Fixed Two Word 

Load Floating Point Register 
Multiply Floating Point 
Negate Floating Point Register 



86 


4 


@M 1 (R 1 ),R 2 


87 


4 


@M-,(Ri) 


89 


4 


@M 1 (R 1 ),R 2 


82 


2 


@Rl 


82 


2 


m^ 


81 


2 


@H^.H 2 


81 


2 


@R 1r R 2 


84 


4 


@Mi(R-|),R 2 


88 


4 


@Mi(R 1 ) r R 2 


80 


2 
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Floating Point Instructions (Optional) (Continued) 
Mnemonic Name 



STOF 
SUBF 



Store Floating Point Register 
Subtract Floating Point 



Code Lgth Operands 



8A 
85 



©M^R-i) 
@M 1 (R 1 ),R 2 



SYSTEM INSTRUCTIONS 

Privileged and restricted classes; consult 7200 or 7300 Processing Unit Reference manual for information 
on the use of these system instructions 

Control Instructions 
Mnemonic 



CTB 

TST 

BCM 

RAR 

WAR 

RRO 

WRO 

SAR 

RSAR 

SBA 

RBA 

SCN 

RCN 

SPM 

RPM 

WRX 



Name 


Code 


Lgth 


Operands 


Clear Tie-Breaker Register 


12 


2 


<1 


Test and Set Tie-Breaker Register 


11 


2 


h 


Branch to Control Memory 


EF 


2 


R V l2 


Read Any Register 


FE 


4 


l 1 (R 1 ),@R 2 


Write Any Register 


FE 


4 


l 1 (R 1 ),@R 2 


Read Register - Option Register 


FD 


4 


l 1 (R 1 ),@R 2 


Write Register - Option Register 


FD 


4 


l 1 (R 1 ),@R 2 


Save All Registers 


FF 


4 


M 1 (R 1 ),l 2 orM 1 (R-|),@R 2 


Restore All Registers 


FF 


4 


M 1 (R 1 ),l 2 orMi(R 1 ),@R 2 


Set Busy/Active Register 


10 


2 


l 1 ,l 2 or@R 1 ,l 2 


Reset Busy/ Active Register 


10 


2 


l 1# l 2 or@Ri,l 2 


Set Control Register 


14 


2 


l 1 ,l 2 or@R 1 ,l 2 


Reset Control Register 


14 


2 


l 1# l 2 or@R 1f l 2 


Set Privileged Mode Register 


15 


2 


ll,l 2 or @Ri,l 2 


Reset Privileged Mode Register 


15 


2 


1 1 ,1 2 or @Ri,l 2 


Write Extended Register 


F0 


2 


E 1# R 2 



I/O Instructions 

DIO 

INP 

OUT 

RDC 

WRC 

SIO 



Disc Input/Output 
Input from I/O Register 
Output to I/O Register 
Communications Input/Output 
Communications Output 
System Input/Output 



F2 


2 


@R 1# R 2 


F5 


2 


l 1# @R 2 


F6 


2 


l 1 ,@R 2 


F3 


2 




F4 


2 


R 1' R 2 


F1 


2 


@R 1r R 2 
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SUMMARY OF EXTENDED MNEMONICS 

The assembler provides extended mnemonic codes which allow unconditional skips, and 
conditional skips and branches to be written in a symbolic form that is easier to use than 
standard machine instructions. The assembler translates the extended mnemonic codes into 
machine instruction object code. 

Extended mnemonic codes for skip instructions do not specify the forward (F) or backward 
(B) direction of the skip. Thus, the extended mnemonic, S, can be used instead of the SF or 
SB machine instruction. The assembler determines the direction of the skip for the S 
instruction from the memory address or immediate value in the operand. For example, S 
DOG skips to the address, DOG, whether DOG is before or after the present location 
counter. 

Extended mnemonic codes for branch and skip instructions that test the condition register 
specify the condition in the mnemonic itself rather than in the operand for example. SOV 
ADDRS skips to ADDRS if overflow has occurred. The standard machine instruction names 
the direction and the bit status in the mnemonic, and the actual bit number tested in the 
operand. Thus, the extended mnemonic SOV 4 is the same as the standard instruction SCTF 
4,0. (Bit of the condition register is the overflow bit.) 

The extended mnemonic codes are grouped as follows: 

Address Coded Skips 

After Arithmetic Instructions 

After Compare Instructions — Arithmetic Test 

After Compare Instructions — Logical Test 

After Decimal Instructions 

After PAKX Instruction 

After TBIT Instruction 

Conditional Register Test 

Just as for the standard instructions, indirect addressing and indexing are optional for the 
extended mnemonic codes. 
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EXTENDED MNEMONIC CODES 



Address-Coded Skips 
Extended Code 



Machine Instruction 



Meaning 

Skip forward or backward 

Skip if reg. is zero, forward or 

backward 

Skip if reg. is non-zero forward or 

backward 

Skip if reg. is plus, forward or 

backward 

Skip if reg. is minus, forward or 

backward 

For S, the l-| value = -255 through +255; for all other extended mnemonics in this category, l<| = -15 
through +15. 

For SF and SB, the l-| value = 0-255; for all other regular instructions in this category l-j = 0-15. 
After Arithmetic Instructions 



S 


Mi or lj 


SF 


h 






SB 


H 


SRZ 


M-|,R 2 or li,R 2 


SRZF 


h' R 2 






SRZB 


l 1f R 2 


SRN 


Mj,R 2 or l-|,R 2 


SRNF 
SRNB 


h' R 2 


SRP 


M 1( R 2 or li,R 2 


SRPF 


l 1# R 2 






SRPB 


l 1f R 2 


SRM 


M^,R 2 or li # R 2 


SRMF 


'1- R 2 






SRMB 


l 1( R 2 



BOV 


©M^R^ 


BCT 


@M-| 


(R! 


>,o 


Branch if overflow 


BNV 


©M^R-,) 


BCF 


@M-\ 


(*-[ 


),o 


Branch if no overflow 


BCY 


@Mi(R-,) 


BCT 


@M 1 


(Ri 


),3 


Branch if carry 


BNC 


©M^R-,) 


BCF 


@Mi 


< R 1 


>,3 


Branch if no carry 


SOV 


M-| or l-| 


SCTF 
SCTB 


>i,o 
■i.o 






Skip if overflow 


SNV 


Mi or l-| 


SCFF 
SCFB 


l 1# 

i 1( o 






Skip if no overflow 


SCY 


M-| or l-j 


SCTF 
SCTB 


l 1# 3 
l,,3 






Skip if carry 


SNC 


Mi or li 


SCFF 
SCFB 


l,,3 
11,3 






Skip if no carry 



l-| = -15 through +15 for the extended instructions. !■] = 0-1 5 for the regular instructions. 

After Compare Instructions — Arithmetic Test 

The arithmetic test tests the result of a signed arithmetic compare between operand 1 and operand 2. In 
the following table, 1 and 2 under Meaning refer to the signed values of operands 1 and 2. 

Meaning 



Extended Code 


Machine Instruction 


BGT @Mi(R.,) 


BCT 


©M^R^.I 


BLT ©M^R.,) 


BCT 


©M^R-,}^ 


BGE ©M^R.,) 


BCF 


©M^R^ 


BLE ©M-,^) 


BCF 


©M^R^J 


BEQ ©M^R^ 


BCT 


©M^R^ 


BNE ©M-ifR.,) 


BCF 


©M^R,)^ 



Branch if 1 GT 2 

Branch if 1 LT 2 

Branch if 1 GE 2 

Branch if 1 LE 2 

Branch if 1 EQ 2 

Branch if 1 NE 2 
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After Compare Instructions — Arithmetic Test (Continued) 



Machine Instruction 



Extended Code 




SGT 


Ml or 


h 


SLT 


M-] or 


'1 


SGE 


M-j or 


h 


SLE 


M-| or 


'i 


SEQ 


Mi or 


h 


SNE 


M-| or 


'1 



Meaning 



SCTF 


<1.1 


SCTB 


'1-1 


SCTF 


'1.2 


SCTB 


h.2 


SCFF 


'1-2 


SCFB 


'1.2 


SCFF 


h-1 


SCFB 


'1.1 


SCTF 


M 


SCTB 


"1.3 


SCFF 


'1-3 


SCFB 


'1.3 



Skip if 1 GT 2 
Skip if 1 LT 2 
Skip if 1 GE 2 
Skip if 1 LE 2 
Skip if 1 EQ 2 
Skip if 1 NE 2 

ll = -15 through +15 for extended instructions. I-| = 0-15 for regular instructions. 

After Compare Instructions - Logical Test 

The logical test tests the results of an unsigned arithmetic (logical) compare between operand 1 and operand 
2. In the following table, 1 and 2 under Meaning refer to the unsigned values of operands 1 and 2. CMPX 
and all variations of the CBY instruction always yield a logical result. 



Extended Code 

BLGT @M t (R.i) 

BLLT (giM^R.,) 

BLGE ©M^R^ 

BLLE @Mi(R,) 

BLEQ ©M^Rt) 

BLNE ©M^R-,) 

SLGT M^r^ 

SLLT M., or li 

SLGE M-, or I-, 

SLLE MtoHt 

SLEQ MtoHt 

SLNE M^r^ 



Machine Instruction 



BCT 


©M^R.,)^ 


BCT 


©M^R-i)^ 


BCF 


©M^R-,)^ 


BCF 


@M-,(Ri),5 


BCT 


©M^R^,? 


BCF 


©M^Rt),? 


SCTF 


'1.5 


SCTB 


'1.5 


SCTF 


l-|,6 


SCTB 


I-I.6 


SCFF 


l 1f 6 


SCFB 


l,,6 


SCFF 


'1.5 


SCFB 


'1.5 


SCTF 


'1.7 


SCTB 


'1.7 


SCFF 


'1.7 


SCFB 


'1.7 



Meaning 

Branch if 1 GT 2 

Branch if 1 LT 2 

Branch if 1 GE 2 

Branch if 1 LE 2 

Branch if 1 EQ 2 

Branch if 1 NE 2 
Skip if 1 GT 2 

Skip if 1 LT 2 

Skip if 1 GE 2 

Skip if 1 LE 2 

Skip if 1 EQ 2 

Skip if 1 NE 2 



ll = -15 through +15 for the extended instructions, li = 0-1 5 for the regular instructions. 



After Decimal Instructions 



BKP 

BKM 



@M 1 (R 1 ) 
©M-^Rj) 



BCT 

BCT 



©M^R^I 



Branch if plus 
Branch if minus 
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After Decimal Instructions (Continued) 

Extended Code Machine Instruction Meaning 

BKZ ©M^R,) BCT @M-|(R.,),3 Branch if zero 

SKP M, or I-, SCTF l v 1 Skip is plus 

SCTB l t 1 

SKM M l0 rl., SCTF l 1# 2 Skip if minus 

SCTB l lf 2 

SKZ MTorl! SCTF l-,,3 Skip if zero 

SCTB l 1# 3 

I'l =-15 through +1 5 for the extended instructions. I -| =0-15 for the regular instructions. 

After PAKX Instruction 

BID ©M^R^ BCT ©M^R-,)^ Branch if invalid digit 

BNI ©M^R^ BCF ©M^R^.4 Branch if no invalid digit 

SID MTorl, SCTF l-,,4 Skip if invalid digit 

SCTB l 1# 4 

SNI Mt or l-| SCFF l 1# 4 Skip if no invalid digit 

SCFB I j A 

ll = -15 through +15 for the extended instructions. I-| = 0-15 for the regular instructions. 

After TB IT Instruction 

BBS ©M^Rj) BCT ©M^R^O Branch if bit is set 

BBR ©M^Rj) BCF ©M^R^O Branch if bit is reset 

SBS Mijorlj SCTF 1^0 Skip if bit is set 

SCTB 1 1,0 

SBR Mjorli SCFF l 1# Skip if bit is reset 

SCFB l 1# 

l-| = -15 through +15 for the extended instructions. Ij = 0-15 for the regular instructions. 

Condition Register Test 

SCF M^ or 1^12 SCFF l 1# l Skip if bit spec, by 1 2 is off 

SCFB l 1( l 

SCT M^^orl!,^ SCTF l 1( l Skip if bit spec, by l 2 is on 

SCTB l 1( l 

1^ = -15 through +15 and l 2 = 0-15 for the extended instructions. I-] and l 2 = 0-15 for the regular 
instructions. 
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4. ASSEMBLER INSTRUCTION SOURCE 
STATEMENTS - OVERVIEW 



Assembler statements are requests to the assembler to perform certain operations during the 
assembly. Some statements, such as WDD and BDD, generate data, while others, such as 
EQU and SPACE, are effective only at assembly time. A summary of assembler statements 
can be found in Appendix E. 

Assembler instruction source statements consist of: 

• Name field (usually optional) 

• Mnemonic operation code 

• Operand field (optional for some statements) 

• Comment field (optional) 

An example of an assembler instruction source statement is: 



NAME 




OPERATION 




OPERAND 


12 3 4 5 6 7 8 


9 


10 11 12 13 14 15 16 17 


18 


19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 


MAMEI 




WJM> . 




0fXi^£X^ GENERATE M ZEROS . 







The following is a list of assembler statements with a short explanation for each statement. 

Program Sectioning and Linking Statements 

CSECT Identifies the beginning or continuation of a control section 

ENTRY Identifies relocatable symbols defined in the current program that are 
used in another program 

EXTRN Identifies relocatable symbols used in the current program that are 
defined in another program 

COM Identifies the beginning or continuation of a common control section 

Program Control Statements 

ORG Sets the location counter 

END Ends the assembly 

PUNCH Writes data in a user-defined file 
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LTORG Assembles literals in a pool 

ICTL Specifies nonstandard input format 

ISEQ Checks the lines of code for the correct sequence 

ALIGN Sets the current location counter to a storage boundary 
Linkage Editor Map Address Directive Statement 

SEG Defines load-module segment 

Symbol and Data Definition Statements 

EQU Defines a symbol and assigns values and attributes to it 

WDD Defines word aligned data (in bytes) 

BDD Defines byte aligned data (in bytes) 

WRS Reserves word aligned storage (in words) 

BRS Reserves byte aligned storage (in bytes) 

FORM Defines bit-oriented formats (in storage bytes) 
Listing Control Statements 

TITLE Identifies the listing 

EJECT Starts a new page 

SPACE Inserts blank lines 

PRINT Specifies the details to be printed 
Macro Definition Statements 

MACRO Begin macro definition 

MEXIT Conditional exit from macro definition 

MEND End macro definition 

MNOTE Macro message 
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Conditional Assembly Statements 

SETA Assigns arithmetic values to set symbols 

SETC Assigns character values to set symbols 

GBLA Defines a SETA symbol as global 

GBLC Defines a SETC symbol as global 

ADO Sets up a source statement generation loop 

AGO Specifies a branch to another statement 

ANOP Specifies an assembly no-operation statement 



4-3 



5. PROGRAM SECTIONING AND LINKING STATEMENTS 



The programmer can divide a lengthy or complex program into control sections to make it 
more manageable and easier to debug. Each section is assigned a unique name. The operating 
system treats each section as an independent, relocatable routine that can be executed alone 
or linked with others. 

During assembly, the assembler creates an index of all assigned control section names. At 
load time, the Linkage Editor uses the index to link the various control sections into a single 
storage module, from which the connected sections can be executed as a complete program. 

The assembler mnemonics and functions of the program sectioning and linking statements 
are: 

CSECT Identifies the beginning or continuation of a control section. 

ENTRY Identifies relocatable symbols defined in the current program that are used 
in another program. 

EXTRN Identifies relocatable symbols used in the current program that are defined 
in another program. 

COM Identifies the beginning or continuation of a common control section. 

(The reserved symbolic segment tag, $SYSEG, is also explained in this section.) 



CSECT - IDENTIFY CONTROL SECTION 

The CSECT statement identifies the beginning or continuation of a control section. The 
format of the CSECT statement is: 



Name 


Operation 


Operand 


Symbol or 
blank 


CSECT 


Not used — ignored by the 
assembler 



If a symbol appears in the name field, it is the name of the control section; otherwise, an 
unnamed control section is defined. The symbol in the name field represents the address of 
the first byte of the control section. It has a length attribute of 1 . 

To preclude the generation of an unnamed CSECT section; the CSECT statement must 
precede all statements except the following: macro and FORM definitions, listing control 
statements, conditional assembly statements, ICTL and ISEQ statements, EXTRN and 
ENTRY statements, PUNCH statements, and comments. 
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If the assembler encounters a statement other than these before a CSECT statement, an 
unnamed CSECT statement is generated. 

All statements following the CSECT statement are assembled as part of that control section 
until another CSECT or COM statement is encountered. A control section can be 
interrupted and then resumed by inserting another CSECT statement with the same name, 
as in the following example. Control section ONE includes all code between the first ONE 
CSECT card and the TWO CSECT card plus all code following the second ONE CSECT card. 
Unnamed control sections can also be resumed. 



ONE 



TWO 



ONE 



CSECT 



CSECT 



CSECT 



Control section ONE 



Control section TWO 



Control section ONE 



SYMBOLIC LINKAGE STATEMENTS - ENTRY AND EXTRN 

The symbolic linkage statements, ENTRY and EXTRN, allow a symbol to be defined in one 
program and referred to in another program. The program defining the symbol uses the 
ENTRY statement; the program referencing the symbol uses the EXTRN statement. In both 
instances, the assembler provides the linkage editor with the information to resolve the 
symbolic linkage. 



ENTRY - IDENTI FY ENTRY POINT SYMBOL 

The ENTRY statement specifies which relocatable symbols defined in the current program 
can be accessed by other programs. The format of the ENTRY statement is: 



Name 


Operation 


Operand 


Sequence 
symbol 
or blank 


ENTRY 


One or more relocatable 
symbols separated by comma 



The symbols in the operand field may be used as operands by other programs. Control 
sections named in CSECT or COM statements are automatically considered entry points and 
do not have to be listed in an ENTRY statement. In the following example, the ENTRY 
statement identifies SUB1 and SUB2 as entry points to the program: 
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1 2 3 1 h 6 7 



OPERATION 



10 11 12 13 14 16 16 17 



ENTRY 



19 20, 21 22 23 24 25,26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 424344 45 46 47 48 49 50 



5UEJ.,£UAA 



EXTRN - IDENTIFY EXTERNAL SYMBOL 

The EXTRN statement identifies relocatable symbols that can be used in the current 
program, although they are defined elsewhere. The format of the EXTRN statement is: 



Name 



Sequence 
symbol 
or blank 



Operation 



EXTRN 



Operand 



One or more relocatable 
symbols separated by commas 



Symbols named in the operand field cannot appear in an ENTRY statement in the same 
program. The combined total of control section and external symbols in the same program 
cannot exceed 252. 

The example in Figure 5-1 shows how two programs, PROGA and PROGB, use EXTRN and 
ENTRY, so PROGA can use symbols defined in PROGB. EXTRN in PROGA identifies 
FETCH as a symbolic address that is defined in another program. ENTRY in PROGB 
defines FETCH as an entry point in PROGB. Thus PROGA can use FETCH as an operand 
without first defining it. 



2 3 4 5 6 7 



PROS A 



t&QGB 



E£TM 



OPERATION 



10 11 12 13 14 15 16 17 



C&fiGT. 
EXTRH 



FETCH 



B» 



END 



GSJEGT 
ENTRY 



LQfcfc 



EliJL 



FEXCJi 



10 20, 21 22 23 24 25 26 27 28 29 30, 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 



fetch 



TAGEjRL 



Figure 5-1 . Example of EXTRN and ENTRY 
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COM - DEFINE COMMON CONTROL SECTION 

The COM statement identifies the beginning or continuation of a common control section. 
The format of the COM statement is: 



Name 


Operation 


Operand 


Symbol 
or blank 


COM 


Not used — ignored by 
the assembler 



If a symbol appears in the name field, it is the name of the common storage area; otherwise, 
an unnamed common storage area is defined. An unnamed COM control section does not 
have the same name as an unnamed CSECT section. If two COM statements with the same 
name appear in the same program, the second is a continuation of the first. When COM 
statements are assembled, the common location assignment starts at zero. The symbol in the 
name field represents the address of the first byte of the control section. It has a length 
attribute of 1 . 

Since a COM control section's primary function is to define the structure of a storage area 
used by more than one program, no binary data can be generated by statements within the 
COM section. However, pertinent storage information such as address assignment, 
repeatability, and length attributes are retained and assembled in the normal way, without 
binary output. 

Data can be stored in a common storage area during assembly only by a CSECT control 
section in a different assembly, in which case the CSECT control section must use the same 
name as the common area defined and reserved by COM statements. After the programs are 
assembled and the Linkage Editor has performed the necessary linkage, data can be 
retrieved, stored, checked, and manipulated in the common area by any cognizant program 
currently being executed. 

No more than one CSECT control section may be included in a set of COM control sections 
identified by the same name in the same load module. 

The example in Figure 5-2 shows how two programs communicate information through the 
common area. Each program must know the other's plan for structuring and using the 
common storage area. If program PROGA is to pass information to PROGB, PROGB must 
know the location in COMMON to which PROGA will pass the data. In this example, 
information is passed through COMMON at location TAGE. In PROGA, the statement STO 
TAG5,R2 stores the contents of register 2 at location TAG5. After the branch is made to 
FETCH, PROGB loads the contents from TAGE (which is the same location as TAG5 in 
PROGA) into its register and checks to see if it is equal to the hexadecimal constant: 'AF'. 
If a true comparison is found, a branch is made to PROGC. Note that when the Linkage 
Editor is called to link the programs at load time, each program is linked to COMMON. 
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NAME 


OPERATION 


OPERAND 


12 3 4 5 6 7 8 


3 10 11 12 13 11 16 16 17 


8 19 20. 21 22 23 21 25.26 27 28 29 30 31 32 33 34 35 36 37 38 39 10 11 42 43 44 45 46 47 48 49 50 


PK06A 
PROS 

comoti 

TAG! 

TA&X 

TAG3 

JAM 

TAGS 


CSECT* 
ENTRY 
EXTRN 

• 
m 

LOD 

STO 

MOYX 

LGJ>J* 

STO 

B 

• 

• 

COM 
VJbb 
tfbb 
tibb 
BRS 

BR3 

* 


— 


PETGH . 

tagi,rl ", [ T. ",/,y,'. '. 

TA6Z,K[ 

rAGH.TAG£ 

tt AFll.JU 

TAGS', JUL 

FETcA 


1 




L -. x. _!.. .. x.. _1 








...... 


< i ■ . i i i i i i i i i i 

XVFF 1 C,.i) 


' ■ 


. . . ■ 








Sxsi .' 

0X4... 3) 






. , , 


iX ..* 

J# - 


1- 1 




. . . . L ... 



12 3 15 6 7 



OPERATION 



10 11 12 13 11 15 16 17 



19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 



PROGB 



C3ECT 
ENTRY 
EXTRN 



fetch; 



COMKON 

TAGA 

T AGB 

TAGC 

TAGD 

"TAGE 

TAG-F 

TAGG 



TAGH 



LObB 
CBY 



C4EGT 

Ubb 

Ubb 

Ubb 

BKS 

.bJUL... 

WOD 

BRS 

brs 



FETCH 
PRO.GC 



TAGE.RI. 
*X.*AlV ,M 

prosg \ 



jjjt 

\fr 



EN1L 



Figure 5-2. Example of the COM Statement 
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RESERVED SYMBOLIC SEGMENT NAME - $SYSEG 

The reserved symbolic segment name, $SYSEG, is a relocatable segment designator which 
makes extended addressing possible. A reserved name has a special meaning to the system 
and should not be used as a symbol for any purpose other than its special meaning. 

Symbolic segment tags are used for address referencing across program (or storage) 
segments. However, a user whose program is limited to one segment need not use segment 
tags. To make all system interfaces (I/O requests and service requests) compatible, addresses 
specified in these interfaces must have an associated segment tag. 

When a single-segment program is written, the assembler assigns the global system name, 
$SYSEG, to the first (and only) segment in the program. $SYSEG is automatically entered 
in the symbol table by the assembler, and thus becomes a reserved identifier. 

The name $SYSEG is used as a default value in all system macros containing address 
parameters. The user must concern himself with $SYSEG only if he is coding system 
interfaces directly without using the regular system macros. 

SSYSEG cannot be used in a multi-term expression. It can only be used as an operand in a 
BDD, WDD, or FORM instruction. If it is used in a FORM instruction, the size of the 
corresponding definition field must be 8 bits in length and start on a byte boundary. The 
length attribute of $SYSEG is 1 . 
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6. PROGRAM CONTROL STATEMENTS 

The assembler mnemonics and functions of the program control statements are: 

ORG Sets the location counter 

END Ends the assembly 

PUNCH Writes data in a user-defined sequential disk file. 

LTORG Inserts the accumulated literal pool, starting at the current location 
counter. 

ICTL Specifies nonstandard input format. 

ISEQ Checks the lines of code for the correct sequence. 

ALIGN Sets the current location counter to a storage boundary address. 



ORG - SET LOCATION COUNTER 

The ORG statement alters the setting of the location counter. The format of the ORG 
statement is: 



Name 


Operation 


Operand 


Sequence 
symbol 
or blank 


ORG 


Relocatable expression or 
blank 



Symbols in the expression must be previously defined. The unpaired relocatable symbol 
must be defined in the same control section in which the ORG statement appears. The 
location counter is set to the value of the expression in the operand, or to its previous high 
count, if the operand field is blank. 

Since the location counter points to a storage location that is to receive the next line of 
assembled code, altering its setting permits a programmer to return to a previous location in 
his program and change its contents. In this way, an area can be redefined during assembly, 
changing data definitions to meet various requirements in the program. 

An example of an ORG statement is: 



NAME 




OPERATION 




OPERAND 


12 3 4 5 6 7 8 


9 


ID 11 12 13 14 16 16 17 


is 


19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 


.FIRST 




OILS 




TAG. . -*-. -. - .. J ... J _^^-^..-i_— — . U-. -..-I ^...± 
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If the location named TAG is twelve bytes from the beginning of the control section, this 
statement sets the location counter to OOOC. Statements that follow the ORG statement are 
then assembled beginning at address OOOC. The information previously assembled at these 
locations is lost, although the name tags remain unchanged and cannot be duplicated. 

The ORG statement can also be used in direct reference to the location counter. The format 
of the operand is *-n or *+n. The asterisk specifies the present location counter, and n 
specifies the number of bytes. The following statement decreases the present location 
counter by 60: 



1 2 3 4 5 G 7 



,SEO> 



OPERATION 



10 11 12 13 14 1!> 1G 17 



ORG 



19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 13 44 16.46 47 48 49 50. 



*-,60 



An ORG statement without an operand returns the location counter to its previous high 
count, as in the following statement. If the counter has already reached its previous high, an 
ORG without an operand has no effect. 



12 3 4 5 6 7 8 



.THRD 



OPERATION 



IH 11 12 13 14 15 16 1/ 



ORG 



19 20 21 22 23 24 25 26 27 28 29 30.31 32 33 34 35 36 37 3839 40 41 42 43 44 45,46 47 48 49 50. 



The following example shows an ORG with a location counter reference and an ORG 
without an operand. If the location counter is 0050 when ORG *-20 is encountered, the 
count is decreased by 20 bytes to 003C. Then if the ORG without an operand is 
encountered before the counter reaches its previous high of 0050, the count is returned to 
0050. 



12 3 4 6 6 7 8 



OPERATION 



10 11 12 13 14 15 16 17 



ORG 



OX© 



9 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45,40 47 48 49 50 



£0 



For an example of an application of the ORG statement, refer to Figure 8-3 in Chapter 8. 
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END - END ASSEMBLY 

The END statement terminates the assembly of a program. The format of the END 
statement is: 



Name 



Blank 



Operation 



END 



Operand 



Ordinary symbol or blank 



An ordinary symbol in the operand field specifies the point to which control is to be 
transferred when loading is complete. The ordinary symbol must identify a symbolic address 
in the current assembly. Substitution is invalid on the END statement. Continuation is 
ignored on the END statement. 



PUNCH -WRITE TO FILE 

The PUNCH statement writes data in a user-defined sequential disk file. The format of the 
PUNCH statement is: 



Name 


Operation 


Operand 


Sequence 
symbol 
or blank 


PUNCH 


Not used 



The PUNCH statement precedes the line of code that is to be written in the file. The line of 
code can be in any format and it cannot be continued. In the following example, //DEF 
I D=l NPUT,F I L=CAT is written in a file defined by the user: 



NAME 




OPERATION 




OPERAND 


12 3 4 5 6 7 8 


9 


10 11 12 13 14 16 Hi 17 


ia 


19 20 21 22 23 24 25 26 27.28 29 30 31 32 33 31 35 36 37 38 30 10 41 42 13 44 45 46 47 48 49 50 


//htf ii 


« 


PUNCH 
INPUT,.*! 


u 


»cAf.: '/:y : ' : ;:::;::: :. ; ;:::::; 



Variable symbols in the line of code are resolved before the record is written to the file. If 
substitution results in a record that exceeds the standard statement size (columns 1 through 
72) or nonstandard size specified by an ICTL statement, excess characters are truncated on 
the right. 

The PUNCH statement does not lend itself to a fixed field format, because as values of 
various lengths are substituted for a variable symbol, the position of the subsequent fields is 
shifted. 

In the following example, values are substituted for the variable symbols $TAG and $VAL 
before the record is written. 
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1 1 3 4 6 6 7 



HAKE IS 



OPERATION 



10 11 12 13 14 15 16 17 



Stag yal|u|e .is. <val 



19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 3G 37 38 39 40 41 42 43 44 45 4 6 47 48 49 50, 

. — i — — — I. !■* 1 1 . m i t-i.*. in -j — ' ' 



If $TAG is equal to AB and $VAL is equal to 75, the record written in the file is: NAME IS 
AB VALUE IS 75. 

If $TAG is equal to CTHIS IS A MESSAGE' and $VAL is equal to 10, the record written in 
the file is: NAME IS CTHIS IS A MESSAGE' VALUE IS 10. 

Notice that the statement VALUE IS. . .is moved to the right to make room for the first 
statement NAME IS. . . . 

A fixed field format may be established by using a variable symbol with as many characters 
(including the ampersand) as the substituted value. 



LTORG - BEGIN LITERAL POOL 

The LTORG statement assembles previously defined literals into a single area called a literal 
pool. All preceding literals, back to the beginning of the program, or back to the last 
LTORG statement, are assembled at the next word boundary. If a LTORG statement is not 
used, all literals are assembled after the first control section. Literals that appear after the 
last LTORG statement are also assembled after the first control section. 

The format of the LTORG statement is: 



Name 


Operation 


Operand 


Symbol 
or blank 


LTORG 


Not used 



A symbol in the name field represents the address of the first byte of the literal pool. The 
length attribute of the symbol is 1 . 



ICTL - INPUT FORMAT CONTROL 

The ICTL statement specifies that statements in a program begin and end in columns other 
than the standard columns 1 and 72. The format of the ICTL statement is: 



Name 


Operation 


Operand 


Not used 


ICTL 


Two decimal arithmetic 
constants separated by 
a comma 
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Both decimal constants are required. The first constant specifies the beginning column 
(1-40). The second specifies the end column (41-120). A comma must separate the two 
constants. 

If the source program does not contain an ICTL statement, the standard format (columns 1 
and 72) is used. Because system macros are always processed in the standard format, they 
are not affected by the ICTL statement. 

Since the ICTL statement establishes a new format, it must be the first statement in the 
program and can be used only once. The ICTL statement cannot be continued. 

The following statement establishes column 10 as the begin column and column 90 as the 
end column. 



NAME 




OPERATION 




OPERAND 


12 3 4 5 6 7 8 


9 


10 11 12 13 14 15 16 17 


18 


19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 


— — - 


- 


IGTX. _. 


-■ 


\<A Ad 







ISEQ - INPUT SEQUENCE CHECKING 

The ISEQ statement specifies that all subsequent statements are to be checked or not 
checked for correct sequence. The format of the ISEQ statement is: 



Name 


Operation 


Operand 


Blank 


ISEQ 


Blank, or two decimal arithmetic 
constants, separated by a comma 



If the operand field is used, both decimal constants must be specified. The first constant 
specifies the column number of the leftmost character of the sequence field; the second 
constant specifies the column number of the rightmost character of the sequence field. A 
comma must separate the two operands. 

Sequence checking begins with the first line following the ISEQ statement and continues up 
to an ISEQ statement without an operand. Checking can be resumed with another ISEQ 
statement. If each succeeding sequence field is not higher in value than that of the preceding 
statement, a sequence error message is generated. A sequence error does not terminate the 
assembly. 

The columns identified by the ISEQ statement must be between columns 73-80 if the 
standard begin and end columns are used, or outside the begin and end columns defined by 
an ICTL statement. 
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Sequence checking is only performed on statements contained in the source program. Macro 
definitions in a macro library or lines generated by a macro instruction are not checked. 
Lines with a blank sequence field are always considered to be in the correct order. 

The operand field of an ISEQ statement may not contain a reference to a variable symbol. 
The ISEQ statement cannot be continued. 



ALIGN - ALIGN LOCATION COUNTER 

The ALIGN statement sets the value of the location counter to an address determined by a 
value in the operand field; the assembler updates the counter to the next highest address 
which is a multiple of the expressed value in the operand. The format of the ALIGN 
statement is: 



Name 


Operation 


Operand 


Symbol 
or blank 


ALIGN 


Absolute 
arithmetic expression 



The operand can be an expression to be evaluated by the assembler; however, all symbols 
must be previously defined. 

In the following example, the location counter is set to the next highest multiple of 4 
addresses. If the location counter is at 1009 when the statement is encountered, it is set to 
100C. However, if the location counter is already set to an address which is a multiple of the 
operand value (1008, 100C, 1010, etc.), the counter is not changed. After alignment, the 
address of the location counter is assigned the symbolic name in the name field. In the 
example, FOUR1 is equal to 100C. The length attribute is always 1. 



NAME 




OPERATION 




OPERAND 


12 3 4 5 6 7 8 


9 


10 11 12 13 14 15 16 17 


18 


19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 


F0URI 




ALIGN 




^ , . .^ 



If the counter is set to an address exceeding 65,53510- an error message is generated and 
alignment occurs. The location counter is set to the value exceeding 65,535-|0- An address 
of 65,600io will set the location counter to 64 10. 
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7. LINKAGE-EDITOR MAP DIRECTIVE - SEG 



The Linkage Editor map directive, SEG, may be used as an assembly language statement. 
The assembler does not process the statement, but simply writes the directives, in their 
source form, on the output file. 

All SEG statements in an assembly must immediately precede the END statement. The only 
statements that can appear between the SEG statement and the END statement are the 
conditional assembly statements SETA, SETC, ADO, AGO, ANOP, and macro instructions 
generating these statements. A SEG statement cannot be continued and no substitution is 
performed. 

The function and format of the SEG statement is described in the publication MRX/OS 
Program Library Services Reference. 
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8. SYMBOL AND DATA DEFINITION STATEMENTS 



The assembler mnemonics and functions of the symbol and data definition statements are: 

EQU Defines a symbol and assigns values and attributes to it. 

WDD Defines word-aligned data (in bytes). 

BDD Defines byte-aligned data (in bytes). 

WRS Reserves word-aligned storage (in words). 

BRS Reserves byte-aligned storage (in bytes). 

FORM Defines bit-oriented data formats (in storage bytes). 



EQU - EQUATE 

The EQU statement assigns values and attributes to a symbol. The format of the EQU 
statement is: 



Name 


Operation 


Operand 


Ordinary 
or variable 
symbol 


EQU 


Expression 



The expression in the operand field can be absolute or relocatable; however, all symbols in 
the expression must be previously defined. 

The symbol in the name field is given the same length, value, and repeatability attributes as 
the expression in the operand field. The length attribute of the symbol is that of the 
leftmost (or only) term of the expression. When that term is a location counter reference (*) 
or an arithmetic constant, the length attribute is 1. The value attribute of the symbol is the 
value of the expression. When the newly defined symbol is referenced in later statements, it 
has all the attributes assigned by the EQU statement. 

The EQU statement can equate symbols to register numbers, immediate data or other 
arbitrary values, as shown in the first two examples of Figure 8-1. 

The EQU statement can also equate symbols to frequently used or complex expressions, so 
that the programmer can use the symbol rather than an entire expression, as shown in the 
last two examples of Figure 8-1. Note that all symbols in the expression must be previously 
defined. 
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* 



I 2 3 4 6 G 7 



M.GLSTEK 



fregi 
ccmf 



E£(l 

NUMBEK 



* IMMEDIATE DATA'- 



OPERATION 



10 11 12 13 14 15 16 17 



LQU 
E-QU 



tf 



19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35. 36 37 38 39 40.41 42 43 44 4546 47 48 49 50 



C* INCORRECT LABEL* 
CHARACTER .CONST AkT 



l*ZS/C 
(X&+bi/iMY+&5r'HAli 



Figure 8-1 . Examples of EQU Statements 



WDD AND BDD - WORD AND BYTE DEFINED DATA 

The WDD and BDD statements define aligned data in storage. The WDD statement aligns the 
data constant defined in the operand at word boundaries; the BDD statement aligns data at 
byte boundaries. Both statements have the same basic format: 



Name 


Operation 


Operand 


Any symbol 
or blank 


WDD or BDD 


One or more operands 
separated by commas 



The name field reflects the address after alignment. 
Operands must be separated by commas and have the format: 



a 


Where 


a(b,c) 


a 


a(b) 




a(,c) 





c = 



A data value to be generated (required); any valid ex- 
pression. If the data value is a forward symbolic refer- 
ence, and no explicit size is coded, it is assumed to be 
a two-byte value. 

A length specification (in bytes); a positive predefined 
absolute expression. If omitted, the length specification 
is the implied size of the expression. If the explicit size 
of a forward symbolic reference is one byte, and if the 
symbol resolves to an arithmetic or string of more than 
one byte, a warning diagnostic is issued. 

A repetition factor; a positive predefined absolute ex- 
pression. If omitted, a repetition of one is assumed. 
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Bulletin: 2202.001-0101 
Date: 3/19/73 



If the length specification or the repetition factor is zero, no data is generated, but the 
location counter is aligned on the specified word or byte boundary. 

Examples of WDD and BDD statements are shown in Figure 8-2. In the last example, if M = 
N, the term 35 is generated. If M ^ N, no data is generated, but the location counter is set 
on a word address, which is given the name NAM4. 




OPERATION 



19 20 21 22 23 24 25 26 27 23 29 30 3! 32 33 34 36 36 3/ 38 33 40 41 42 43 44 45 46 47 48 49 50 



C'.MALU 



iLXs'ieO 



•X.'JWB 



£®> 



N> 



Figure 8-2. Examples of WDD and BDD Statements 



The value attribute of the symbol in the name field is the address of the leftmost byte after 
alignment. The length attribute is the length in bytes (specified or implied) of the first (or 
only) data field in the operand. 

Omitted operands, signified by a comma without a data value, indicate a zero byte or word. 
The last data value in a string of multiple operands must be a specified data value, not an 
omitted operand. 

Consider the following example. Notice that an arithmetic constant, such as 45, uses two 
bytes. 



Statement 



WDD ,12, ,,45 



Generated Data 

00 00 Word 1 

00 0C Word 2 

00 00 Word 3 

00 00 Word 4 

00 2D Word 5 



If the data value is a relocatable expression other than $SYSEG, the length specification and 
the repetition factor have the following restrictions: 

1. The length attribute must be resolved to two bytes. If the length is 
not specified, two bytes are assumed. 

2. Alignment must be on a word boundary. 

For $SYSEG, the length attribute is 1 and alignment must be on an odd boundary. 
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Literals (which are always relocatable) in a WDD or BDD statement require special 
consideration. If a literal term is used in the WDD or BDD statement, the implied length and 
repetition attributes are (2,1). If other specifications are included, they refer to the literal 
term itself, but not to the symbol defined in the name field. Consider this statement: 



OPERATION 



12 3 4 6 6 7 



10 11 12 13 14 IS 16 17 



19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 



RJ 



WflJL 



§&lABCfl^€4fu£)— 



The length attribute of the literal C'ABCD'(5,2) is 10; but the length attribute of the 
symbol B1 is 2, because the operand is a relocatable term. In all other cases, the symbol in 
the name field receives the length attribute of the first data field in the operand. 

If the location counter (*) is referenced in the operand field, the value attribute of the 
symbol in the name field replaces the operand. For example, TAG WDD *,*,* generates 
three words of data, each assigned the value attribute of TAG. If TAG is equal to to 1004, 
then 1004 1004 1004 is generated. 

For example, the following statement specifies that two 8-byte fields of all zeros are to be 
generated. TAG represents the address of the first byte of generated data. 



NAME 




OPERATION 




OPERAND 


12 3 4 5 6 7 8 


9 


10 11 12 13 14 15 16 17 


18 


19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 


ra& _ _ 




W£fc 




pCHtZYtJlXH, 2) . . ... _ 









If the location counter is pointing to 00FE, TAG is equal to 00FE and the storage locations 
are as follows. (The last byte is 01 0D or TAG+15.) 



Locations 



Contents 



OOFE 
0100 
0102 
0104 
0106 
0108 
01 0A 
01 0C 



00 00 

00 00 [ st °P eran d 

00 00 
00 00 

«»f Second operand 
00 00 



If the location counter is pointing to an odd-byte address when a WDD statement is 
encountered, the assembler automatically updates the counter to the next word boundary 
and does not affect the contents of the odd-byte address. 

In the preceding example, if the location counter is pointing to 00FD, the assembler updates 
the counter to OOFE and the contents of 00FD are unchanged. The storage locations are as 
follows. 
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Locations 


Contents 




OOFC 


XX XX 


xx indicates that the contents are 


OOFE 


00 00 


residual data 


0100 


00 00 




0102 


00 00 





01 oc 



00 00 



TAG, then is equal to OOFE. However, if TAG BDD 0(4,2), 0(4,2) is specified rather than 
TAG WDD 0(4,2),0(4,2) and the location counter points to OOFD, the first zero byte is 
stored at address OOFD and the last byte at address 010C. TAG is equal to OOFD. 

If multiple operands are specified, each operand is word-aligned for the WDD statement, or 
byte-aligned for the BDD statement, as in the example: 



Statement 



Generated Data 



WDD TAG1,X'13',X'05',TAG2 



TAG1 
13 xx 
05 xx 
TAG2 



Word 1 
Word 2 
Word 3 
Word 4 



Where: 



TAG1 = a two-byte relocatable tag 
xx = contents are residual data 
TAG2 = a two-byte relocatable tag 



WRS AND BRS - WORD AND BYTE RESERVE STORAGE 

The WRS and BRS statements reserve storage without preset data. The format of the WRS 
and BRS statement is: 



Name 


Operation 


Operand 


Any symbol 
or blank 


WRS or BRS 


Absolute 
arithmetic expression 



The symbol in the name field is the address of the first byte, and has the length attribute 
(number of bytes) of the storage area. 
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The operand of the WRS statement specifies the number of words to reserve; the operand of 
the BRS statement specifies the number of bytes. Symbols used in the operand field must 
be previously defined, and when evaluated must equal a positive, absolute arithmetic value. 
If the operand is zero, the location counter is aligned on the specified word or byte 
boundary. 

In the following example, WRS and BRS each reserve 800 bytes of storage. The first byte of 
the WBUFF area begins on a word boundary, while no distinction between odd or even 
address bytes is made for BBUFF. 



NAME 




OPERATION 




18 


OPERAND 


12 3 4 5 6 7 8 


9 


10 11 12 13 14 15 


16 17 


19 20 21 22 23 24 2b 26 27 28 29 30 31 32 33 34 36 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 


BBUFF 
fe/BUFF ' ' 




BRS 






W 

, L ± . .,. j. ._ , L .._.-.- ^ ... ^ .... 1 . ■ - - I I • - ->• - > • ■ - i- i . . l . . ..1 

i , , , I . , 1 . i ..1 .. 1 i 1.1 11 i.i 1 i . _1_ 1 . . 1- -L .... 1__1_ .1 1 



In Figure 8-3 the example shows the use of an ORG statement in conjunction with WDD 
and BRS. After the second ORG statement, the value of TAG1(29,1) is: CONTENTS OF 
ABCD ARE INVALID. 



12 3 4 5 6 7 8 



OPERATION 



10 II 12 13 14 15 16 17 



19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 



AGl 
AGX 

A&3 



WJ)D 
BRS 



ORG 
WDD 
ORG 



END 



C ZMTEHT3 OF 
S 



CARE. 



TAQX 
CVABCD 



INVALU.' 



RETURNS 
INSERTS 
CT.R SET 



CTR to. 
CtfARVS 
TO PRE.V 



TAG2 
AT TAG* 

ioas. HIGH 



Figure 8-3. Example of an ORG Statement with WDD and BRS 
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FORM - DEFINE DATA FORMAT 

The FORM definition statement defines a symbolic name to be used as a mnemonic in the 
operation field of a subsequent statement, and specifies the size (in bits) and storage 
alignment of each operand to be used with the mnemonic. The format of the FORM 
definition statement is: 



Name 


Operation 


Operand 


Ordinary 
symbol 


FORM 


One or more positive arithmetic 
expressions separated by commas 



The name field which is required, defines the mnemonic operation code for a FORM 
instruction statement. Expressions in the operand field must equal a number between 1 and 
255. Symbols in the operand field must be previously defined. 

The FORM definition statement in the following example defines a mnemonic, STAR, and 
specifies that its first operand is assigned four bit positions; the second, four also; and the 
third, eight bit positions. 



12 3 4 5 6 7 



STAK 



OPERATION 



10 11 12 13 14 15 16 17 



FARM 



19 20 21 22 23 24 2526 27 28 29 30 31 32 33 34 35 36 37 38 33 40 41 42 43 44 4546 47 48 49 50 



H.^Tt. | JO 



FORM - INSTRUCTION STATEMENT 

The FORM instruction statement specifies the data to be generated according to the format 
defined by the corresponding FORM definition statement. The format of the FORM 
instruction statement is: 



Name 


Operation 


Operand 


Any symbol 
or blank 


FORM name 


Exp,exp,. . .,exp 



The FORM name in the operation field must be previously defined in a FORM definition 
statement. 

The operand field may contain any valid expressions, separated by commas. No alignment is 
performed before data generation. The values specified in the operand field of the FORM 
instruction are matched by position to the fields defined in the operand of the 
corresponding FORM definition statement. 

Missing operands (signified by contiguous commas) are replaced with zeros. If the number 
of operands in the instruction does not match the number specified in the definition, an 
error message is generated. 
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If the symbol in the name field of a FORM definition is a mnemonic used in more than one 
type of instruction, the assembler assigns attributes to the instruction according to the 
following hierarchy: 

1 . Machine and assembler instructions. 

2. User macros and user FORM instructions within user macros. 

3. User FORM instructions outside macros. 

4. System macros and FORM instructions within system macros. 

For example, if the programmer codes the following statements, the assembler treats the 
statement &A EQU "A as an assembly language statement (1. above) rather than a FORM 
instruction. 



12 3 4 5 6 7 



eau 
U 



OPERATION 



11 12 13 14 l f J 16 17 



FORM 
E.QU 



IS 20 21 22 23 24 2b 26 27 28 29 30 31 32 33 34 36 36 37 38 39 40 41 42 43 44 45,46 47 48 49 50 






If the value of an expression is relocatable and not $SYSEG, the following conditions must 
be met; or a relocation error occurs and the expression is made absolute: 

1. The size of the corresponding FORM definition field must be 16 bits 
in length. 

2. The field must begin on a word boundary. 

If the operands of a FORM instruction statement do not use a complete byte, the remainder 
of the byte is unchanged. For example, the FORM definition statement, SIGN FORM 1,5,3 
specifies that 9 bit positions are required for the operands. When a FORM instruction, such 
as .A1 SIGN A< EQ>B,"B,0 calls this definition, the assembler uses two full bytes, but the 
last 7 bit positions of the second byte are zeros. 

If $SYSEG is used as an operand in a FORM instruction, the size of the corresponding 
FORM definition field must be 8 bits and start on a byte boundary. 



PADDING AND TRUNCATION RULES FqR FORM STATEMENTS 

Padding and truncation is done according to the following rules: 

1 . Hexadecimal values are right-justified with zero fill on the left. If the 

actual data is larger than the defined field, the data is truncated on 
the left. 
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Bulletin: 2202.001-0101 
Date: 3/19/73 

2. Alphanumeric character constants are left-justified with blank fill on 
the right. If the actual data is larger than the defined field, the data is 
truncated on the right. 

3. Packed decimal values are right-justified with zero fill on the left. If 
the actual data is larger than the defined field, the data is truncated 
on the left. 

4. Zoned decimal values are right-justified with zero fill on the left. If 
the actual data is larger than the defined field, the data is truncated 
on the left. 

5. Integer string values and arithmetic values are right- justified with the 
sign propagated on the left. If the actual data is larger than the 
defined field, the data is truncated on the left and the sign is lost. 

6. Floating point values are expanded with zero fill on the right. If the 
actual data is larger than the defined field, the value is truncated on 
the right. 

The examples in Figure 8-4 illustrate certain padding and truncation rules. The first operand 
of TAB1, a hexadecimal 5 (0101), is truncated on the left and the two rightmost bits (01) 
are inserted in the 2-bit field defined by 2 in the FORM definition statement. If the value 
attribute of B in the second operand is less than C, the single bit position established in the 
corresponding definition statement is set to a binary 1 . If B is greater than C, the bit is set to 
a binary 0. 

The first A character constant (1100 0001 in EBCDIC) in the second TABLE statement is 
truncated on the right, and the remaining two leftmost bits (11) are assigned to location 
TAB2. Note, however, that all eight bits (1 100 0001 ) of the second A character constant in 
the fourth operand position are retained at location TAB2+1. 



2 3 4 6 6 7 8 



TAB! 



OPERATION 



10 11 12 13 14 15 16 17 



EMM . 
T~ABJ-,E. 



19 20, 21 22 23 24 25.26 27 28 29 30 31 32 33 34 35. 36 37 38 39 40.41 42 43 44 45,46 47 48 49~~5lT 



i> ^ ^,, ^t ji . ^.+-^-^^^^.^_^_., __._ , , 



Figure 8-4. Examples of Padding and Truncation for Form Statements 



The following examples show a possible use of the FORM statement - redefining 
instructions to create a new language closer to English. In the first example, the "MOVE" 
instruction generates a MOVM machine instruction, using a FORM statement and a series of 
Equates. This corresponds to: MOVM BUFFERB(R2),@BUFFERA(R3). Assuming that 
BUFFERA is at address 63FA, the code generated is: 

602 B 
63 FA 
63FC 
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12 3 4 5 6? 



DIRECT 
tNbXRECTi 

R3 
MEMORY 

MOVE 

&.UFFERA 
RUFFERB 



OPEHATION 



10 II 12 13 14 16 16 17 



e&u. _ 

EQU 
EQU 

EQU . 
EQU 
FOAM 
W>3> .... 
WDD. . 
MOVE 



19 20 21 22 ?3 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45,46 47 48 49 5Q t 



_-_.. X -_4_ 





L- - ___... .. 

ii . ..__..... 

3. .__...._ „ __. _ 

X^' 

A , . I A-Li,. 1 4, J 6 

C «. '( A.) .. . , _. .___._____--.-_. __ 

mem o rV ^xjlecx, !r* ^Immkect:,!^! > 

BUFFERS. , BU F FERA ..._. ..___________. ___ ^ 



_JU .._._„. i..-.j„_l_ 



The next example shows a BRANCH FORM statement used alone to generate a BR machine 
instruction, or together with ROUTINE to generate a BSR machine instruction. Assuming 
that SUBROUT1 is at 2F3A, the code generated is: 

EA07 

2F3A 

The last statement of this example, BRANCH REGISTER, R7, generates the code: EB07. 



OPERATION 



12 3 4 5 6 7 



10 11 12 13 14 15 16 17 



19 20 21 22 23 24 25 2C 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 474849511 



&AVEKTH 

RZ_ 

REGISTER 
BRANca, 
ROUT IKE 



SUBR0UT1 



EQU 

EGlU 

EQU 

FORM 

FORM 

BRANCH 

ROUTINE 

: ou 

BRANCH 



X'.EA' 

7 

X'EB' 

M 

1.6 

SAVERTN..R7 
SUB ROUT I 

*...._ 

REGISTER, R7 



l_.,l.. -...!-..- . .. _*-—-. 1 L— -■ L 

1... j - i - A J. 1 1 1 1- 

1 i..-..i J i 1 1 > J i U 

l_i I -. i 1 .1 —J J— .-__- _J- 



..__„... J. L_.--.l_-. I J--- i- -J — L_ _l__L. 

I .1. -.....-J... -1—.L..1 1 1— J L. 



A detailed example of the FORM instruction can be found in Appendix F. 
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9. LISTING CONTROL STATEMENTS 



The listing control statements control the printing of the lines of code generated by the 
assembler. The statements themselves are used only for the source listing and are not carried 
over to the object program. 

The assembler mnemonics and functions of the listing control statements are: 

TITLE Identifies the listing. 

EJECT Starts a new page. 

SPACE Inserts blank lines. 

PRINT Specifies the details to be printed. 
TITLE, SPACE, and EJECT statements do not appear in the source listing. 

TITLE - IDENTIFY LISTING 

The TITLE statement specifies the program ID and the heading to be printed on each page 
of the listing. The format of the TITLE statement is: 



Name 


Operation 


Operand 


Symbol 
or blank 


TITLE 


Character string constant 



The first symbol (except a sequence symbol) in the name* field of any TITLE statement is 
printed in the program ID area at the top of each page of the entire listing. The name field 
of all other TITLE statements must contain a sequence symbol or a blank. 

The character string in the operand field specifies the heading for each page. Any variable 
symbols in the character string are resolved. The resolved character string must not be more 
than 90 characters. 

When the TITLE statement appears in a source program, the assembler ejects the current 
page and prints the specified title on the top of the next page. This title is printed on the 
top of each page until another TITLE statement appears. 

In the following example, PGM1 and FIRST SUBROUTINE is printed on all sheets of the 
listing until another TITLE statement appears: 
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12 3 4 6 6 7 



P6MI 



OPERATION 



10 11 12 13 14 15 16 17 



TITLE 



10 21 22 23 24 26.26 27 28 29 30 31 32 33 34. 35, 36 37 38 39 40 41 42 43 44 45,46 47 48 49 50, 



G'JPIjW, SUBROilTXM£V 



Assume that this heading has been printed on six sheets, and the following TITLE statement 
is encountered while the sixth sheet is being printed. 



12 3 4 5 6 7 



,5ECJ> 



10 11 12 13 14 15 16 17 



TITLE. 



19 20. 21 22 23 24 25 26 27 28 29 30, 31 32 33 34 35, 36 37 36 39 40 41 42 43 44 45,46 47 48 49 50, 



C SECOHfc l SmRMTXNE .' 



__i i i 



The assembler halts the printing and ejects the sixth sheet. The new heading, SECOND 
SUBROUTINE, is printed on the seventh sheet. Printing then continues with the seventh 
sheet. Note that a sequence symbol in the name field does not change the program I D. 



EJECT - START NEW PAGE 

The EJECT statement ejects the remainder of the page and resumes the printing at the top 
of the next page. The format of the EJECT statement is: 



Name 


Operation 


Operand 


Sequence 
symbol or 
blank 


EJECT 


Not used — ignored by the 
assembler 



The EJECT statement can be used to separate routines in a program listing. Two successive 
EJECT statements leave the remainder of the current sheet plus the entire next sheet blank. 
A TITLE statement immediately followed by an EJECT statement produces a page that is 
blank except for the heading specified in the TITLE statement. 



SPACE - INSERT BLANK LINES 

The SPACE statement inserts one or more blank lines in a listing. The format of the SPACE 
statement is: 



Name 


Operation 


Operand 


Sequence 
symbol 
or blank 


SPACE 


Absolute 
arithmetic expression 
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The assembler evaluates the expression in the operand field to determine the number of 
lines to leave blank. Symbols in the expression must be previously defined. If the number of 
lines to be left blank exceeds the number left on the current page, the SPACE statement 
functions as an EJECT statement, and the next line is printed on the top of the next page. 
An example of a SPACE statement is: 



NAME 




OPERATION 




OPERAND 


12 3 4 6 6 7 8 


9 


10 It 12 13 14 15 16 17 


18 


19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 


..FUST. 








CA<£Q>B)*^+I 























PRINT - PRINT OPTIONAL DATA 

The PRINT statement controls the extent of the printing. The PRINT statement cannot 
appear within a macro. The format of the PRINT statement is: 



Name 


Operation 


Operand 


Sequence 
symbol 
or blank 


PRINT 


One to four operands 
separated by commas 



The operands, which may appear in any order, specify the amount of data to be printed. 
The two choices for each operand are: 

1. ON A listing is printed. 
OFF Mo listing is printed. 

2. GEN All statements generated from a macro instruction 

are printed. 
NOGEN Only the macro instruction is printed. 

3. DATA Generated data is printed in full. 

NODATA Only the leftmost eight bytes of generated data are 
printed. 

4. COND Conditional statements are printed. 
NOCOND Conditional statements are not printed. 

The operand cannot contain a variable symbol. Each condition specified by the operands 
remains in force until it is changed by another PRINT statement. A program can contain 
any number of PRINT statements. If a PRINT statement does not appear in a program, or 
until it does appear, the assembler assumes the following conditions: PRINT 
ON,NODATA,GEN,NOCOND. 
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For example, the following statement requests the assembler to assemble 256 bytes of 
zeros: 



12 3 4 5 6 7 8 



TAB! 



OPERATION 



10 11 12 13 14 15 16 17 



M>J> 



19 20. 21 22 23 24 25.26 27 28 29 30. 31 32 33 31 35. 36 37 38 39 40.41 42 43 44 45.46 47 48 49 50, 



0CXSA1 



If the operand DATA is included in the last PRINT statement, the listing contains all 256 
bytes of zeros. If the last PRINT statement included the operand NODATA, only eight 
bytes of zeros are listed. 

If the operands of a PRINT statement are contradictory (such as OFF and DATA), the 
assembler determines the printing according to the following priority: 

1. ON or OFF 



2. 



GENorNOGEN 



3. DATA or NODATA, and CON Dor NOCOND 

When NOCOND is specified, conditional statements with errors are printed unless OFF is in 
force, or the statement occurs in a macro when NOGEN is in force. 

Note that the line numbers generated will not be in sequence when NOGEN or NOCOND is 
specified. Jumps in the line numbers indicate that statements were not listed due to NOGEN 
or NOCOND. However, if the suppressed statements contain errors, the error messages still 
refer to lines which do not appear in the listing. 
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10. MACRO LANGUAGE AND CONDITIONAL 
ASSEMBLY STATEMENTS 



The macro language and conditional assembly statements are so closely related that it is 
difficult to explain either concept by itself. Thus, this section is divided into two 
subsections. The first explains the basic structure and application of the macro language. 
Sufficient information is supplied to write a simple macro definition and instruction. The 
second subsection deals with specific conditional assembly statements and their use within 
more complex macros and assemblies. 



MACRO LANGUAGE 

The macro language provides a convenient way to generate a desired sequence of assembler 
statements many times in one or more programs. The principal features are the macro 
definition and the macro instruction. The macro definition is a composite piece of coding 
which serves as a prototype for generating source statements. The macro instruction is a 
single statement which calls the macro definition for assembly and assigns values to the 
variable symbols in the macro definition. 

The macro definition is written only once; the macro instruction is written each time a 
programmer wants to generate the desired sequence of statements. This facility can help 
simplify the coding of a program and reduce the chance of coding errors. 

Macro definitions must appear in a source program before all PUNCH statements and 
statements pertaining to the first control section; consequently, only EJECT, PRINT, 
SPACE, TITLE, ICTL, ISEQ, and comment statements can validly precede the first macro 
definition. All of these statements except ICTL can appear between macro definitions. 

A macro definition cannot appear within a macro definition; however, one macro can call 
another macro. 



MACRO DEFINITION 

A macro definition has four parts: 

1 . Header statement 

2. Prototype statement 

3. Model statements 

4. Termination statement 
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HEADER STATEMENT 

The header statement identifies the beginning of a macro definition. It must be the first 
statement of a macro definition. The format of the header statement is: 



Name 


Operation 


Operand 


Blank 


MACRO 


Blank — ignored by the assembler 



PROTOTYPE STATEMENT 

The prototype statement specifies the mnemonic operation code and the format of macro 
instructions that call the macro definition. The prototype statement must be the second 
statement of every macro definition. The format of the prototype statement is: 



Name 


Operation 


Operand 


Symbolic 
parameter 
or blank 


Mnemonic 

operation 

code 


— 35 symbolic parameters 



The name field may be blank, or it may contain a symbolic parameter. 

The mnemonic operation code in the operation field is the macro name used to call the 
macro definition for assembly. This code must not be used in another macro definition, nor 
can it be a recognized mnemonic of a machine or assembler instruction. 

The operand field may contain through 35 symbolic parameters, separated by commas. 
The first four characters of a symbolic parameter should not be &SYS. Comments can 
appear only if symbolic parameters are present. 

The symbolic parameters in the name field and the operand field represent variable values 
that are supplied by the programmer when he calls the macro for assembly. Subsequent 
model statements use these symbolic parameters. 



The operands in a prototype statement can be positional or keyword, 
positional operands cannot both be used in the same prototype statement. 



Keyword and 



Positional operands require that the operands of a macro instruction be written in the same 
order as the corresponding symbolic parameters of the prototype statement. Positional 
operands cannot have a default value and must begin with an ampersand (&) followed by 
one to seven alphanumeric characters, the first of which must be alphabetic. Examples of 
positional operands are &PAR1, &P, &P2. 
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Keyword operands may appear in any order in the macro definition and the macro 
instruction, because the parameters are recognized by the keyword, not by the order or 
position of the symbolic parameter in the prototype statement. Keyword operands may be 
assigned default values. A default value must be a standard value, not a variable symbol. 
Keyword operands are similar to positional operands, except that keyword operands are 
immediately followed by an equal sign and optionally followed by a standard value. If a 
value is not assigned, the default value is null. Examples of keyword operands are: 
&PAM 1 =22,&P=C'ABCD',&PAM3=. 

The length of a prototype statement can be any number of lines. Continued lines must end 
with a semicolon. A semicolon may not be the first character of a continuation line. 



MODEL STATEMENTS 

Model statements are the macro definition statements from which the assembler language 
statements are generated. Zero or more model statements may follow the prototype 
statement. In the use of special characters, model statements must follow the same rules as 
macro instruction operands. The rules pertaining to special characters in macro instructions 
are discussed under Special Characters in a Macro Instruction later in this chapter. Model 
statements must also follow the normal continuation line rules, and statements generated 
from model statements must not require more than 160 characters. Only generated 
statements appear in the listing. The format of the model statement is: 



Name 


Operation 


Operand 


Any symbol 
or blank 


Instruction or 
variable symbol 


Any symbols or terms 



The name field may be blank, or may contain a symbol. Because a sequence symbol inside a 
macro definition is local to that definition, the same sequence symbol can be used in 
another macro or outside the macro definition. However, within the same macro definition, 
a sequence symbol can be generated only once. Thus, a sequence symbol may be used in 
more than one model statement, provided that the statements which duplicate it are skipped 
due to conditional assembly. Note that because prototype statements are not generated, the 
symbol in the name field of a prototype statement can be duplicated and generated in a 
model statement. The characters * and . * or a sequence symbol cannot be substituted for a 
variable symbol in the begin position of a model statement. If the model statement is an 
inner macro instruction, the name field must follow the rules for macro instructions. 

A variable symbol can be concatenated with other characters in the name field. 

The operation field may contain a machine instruction, an assembler instruction, a macro 
instruction, a form instruction, or a variable symbol. However, the following assembler 
instruction mnemonics cannot be used in the operation field of a model statement: 
MACRO, PRINT, ISEQ, ICTL, and END. Variable symbols cannot be used to generate an 
ADO, AGO, ANOP, SETA, SETC, PUNCH, MEXIT, GBLA, GBLC, MNOTE, CSECT, COM, 
MACRO, SEG, PRINT, ISEQ, ICTL, or END mnemonic, or macro instruction mnemonic 
operation codes. 
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The operand field may contain ordinary, variable, or sequence symbols, or other terms, 
depending upon the instruction in the operation field. A symbolic parameter in the operand 
field of a model statement must first be defined in the prototype statement. Comments can 
appear after the last operand. No substitution is made for variable symbols in a comment. 

A model statement may be a comment statement. An asterisk in the begin column indicates 
that the entire line is a comment statement. The assembler converts a model comment 
statement into an assembler language comment statement. 

The programmer may also write comment statements in a macro definition which are not to 
be generated. These statements must have a period in the begin column, immediately 
followed by an asterisk and the comment (/comment). 

The line following a PUNCH model statement is the only exception to model statement 
format rules. Format rules do not apply because the line contains output data, and all 
characters between the begin and end positions are in free format. Substitution is performed 
for all variable symbols between the begin and end positions. 

Relationship of Model and Prototype Statements: Figure 10-1 illustrates the relationship 
between model statements and the prototype statement. Notice that the symbolic 
parameters &TAG1, &TAG2, &TAG3, and &TAG4 are defined in the prototype statement 
before they are used in the model statements. 
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Figure 10-1. Macro Definition 
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TERMINATION STATEMENT 

The termination statement specifies the end of a macro definition. It can appear only once 
within a macro definition and must be the last statement of the definition. The format of 
the termination statement is: 



Name 



Sequence 
symbol or 
blank 



Operation 



MEND 



Operand 



Blank — ignored by the assembler 



MACRO INSTRUCTION 

The macro instruction performs the following functions: 

1 . Calls the macro definition for assembly. 

2. Assigns values to the symbolic parameters in the macro definition. 

The macro instruction closely parallels the prototype statement. The values in the macro 
instruction are equated to the symbolic parameters in the prototype statement. The format 
of the macro instruction is: 



Name 


Operation 


Operand 


Ordinary 


Mnemonic 


— 35 operands 


symbol, 


operation 




sequence 


code 




symbol. 






or blank 







The name field may be blank, or it may contain an ordinary symbol or a sequence symbol. 
An ordinary symbol is defined in the assembly only if a symbolic parameter is both in the 
name field of the prototype statement and in the name field of a model statement. If the 
model statement which has the symbolic parameter in its name field is skipped as a result of 
conditional assembly, the statement is not generated. Consequently, the ordinary symbol in 
the name field of the macro instruction is also not generated. 
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A sequence symbol in the name field of the macro instruction is never carried over to the 
name field of the generated model statement. This sequence symbol can only be used in the 
operand field of an AGO statement - never as the second operand of an ADO statement. 

The mnemonic operation code in the operand field must be previously defined in a macro 
definition or in the system macro library. 

The number of operands in the operand field may not exceed the number of operands in the 
prototype statement. An operand can have up to 1 27 characters. 



POSITIONAL OPERANDS 

If the prototype statement has positional operands, the operands of the macro instruction 
correspond to the symbolic parameters in the prototype statement, and the operand values 
are applied to the symbolic parameters in sequence. If the macro instruction has fewer 
operands than the prototype statement, the unmatched symbolic parameters in the 
prototype are assigned null values, not blanks. Two contiguous commas in the operand field 
indicate an omitted operand, which is also assigned a null value. The examples in Figure 
10-2 illustrate positional operands. 



Prototype: &LABEL POS &TAB1,&TAB2,&TAB3 Values: &TAB1 = 42 

Instruction: .FIRST POS 42,15,63 &TAB2 - 15 

&TAB3 = 63 
Instruction: SEC POS 16..2 Values: &TAB1 = 16 

&TAB2 = null 
&TAB3 - 2 

Figure 10-2. Macro Instruction — Positional Operands 



KEYWORD OPERANDS 

If the prototype statement has keyword operands, the macro instruction must also have 
keyword operands. The instruction keyword, which is all characters before the equal sign, 
must directly match the keyword in the prototype operand, except that the instruction 
keyword operand is not preceded by an ampersand. The value following the equal sign in 
the macro instruction is assigned to its corresponding symbolic parameter. Symbolic 
parameters not matched by a macro instruction operand retain their default value. The 
examples in Figure 10-3 illustrate keyword operands. 
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Prototype: &LBL 
Instruction: .THD 

Instruction: .FOUR 



KEY i&PARM1-5,&PARM2-,&PARM3-C'VALUE' 

KEY PARM3-C'PRICE',PARM1-100 

KEY PARM1-ABCD,PARM2="7B 



Values: &PARM1 - 100 
&PARM2 - null 
&PARM3 = C'PRICE' 

Values: &PARM1 - ABCD 
8.PARM2 - "7B 
&PARM3 - C'VALUE' 



Figure 10t3. Macro Instruction — Keyword Operands 



SPECIAL CHARACTERS IN A MACRO INSTRUCTION 

A macro instruction operand may consist of any combination of up to 127 characters, 
provided the syntactical rules for the following special characters are observed. These 
characters have special meanings in a macro instruction operand. 



escape character (#) 
ampersand 
apostrophe 
parentheses 



• comma 

• semicolon 

• blank 



Escape Character 

The first character after an escape character retains its literal value. Therefore, if a special 
character is to retain its literal value, it must be preceded by an escape character. For 
example, the following operand field has three operands: 

#(CjM,jy,,XYZ 

12 3 
Escape characters are part of the operand value and are carried over to the model statements. 



Ampersand 

An ampersand followed by a letter indicates the start of a variable symbol. During assembly, 
the current value is substituted for all variable symbols found in a macro instruction. In the 
following example, only &V1 is substituted. 

C A&V 1 #& V2',C #&V3 #&V4',AB+X'&V 1 



10-7 



Apostrophe 

An apostrophe immediately preceded by the letter C signifies the start of a character string 
constant. The character string constant extends to the next apostrophe. Parentheses, 
commas, and blanks lose their special meanings when they are enclosed in a character string 
constant, as in the example: 

C'A,BC( 539' 

The comma, blanks, and left parenthesis are part of the character string constant. In any 
other context, the apostrophe retains its literal value. 



Parentheses 

An operand beginning with a left parenthesis and ending with a right parenthesis signifies an 
operand sublist. Within a sublist, the comma is a suboperand separator, not an operand 
separator. Special characters, other than the comma, retain their special meanings within a 
sublist. Parentheses that do not specify an operand sublist retain their literal value. 
Examples of operands with parentheses are: 

A,(B,C) Two operands: [A] [(B,C)] 

A(B,C) One operand — operand does not begin with a left 

parenthesis 

(A+B)/2(R,4) One operand — operand does not begin and end 

with matching parentheses 



Comma 

The comma separates operands or suboperands, unless the comma is inside a character string 
constant, preceded by an escape character, or follows a left parenthesis that is not the 
opening parenthesis of a sublist. In these three cases, the comma retains its literal value. 
Examples of operands with commas are: 

A,B,C Three operands: [A ] [B ] [C] 

A #,B #,C One operand: comma preceded by # 

B(C,4+K One operand: comma preceded by ( 



Semicolon 

The semicolon indicates line continuation. Characters following a semicolon are considered 
comments. The semicolon cannot be the first character of a continuation line. The current 
line continues with the first nonblank character of the next line, as in the following 
example: 
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A,BHCD,52,;HERE HERE is a comment. The four operands are: 

CON [A ] [BHCD ] [52 ] and [CON] . 



Blank 

A blank signifies the end of the operand field. Characters following a blank are considered 
comments. 



SUBLISTS IN MACRO INSTRUCTIONS 

To group a number of suboperands as a single symbolic parameter value, the macro 
instruction operand is written as a sublist. A sublist consists of one or more suboperands 
separated by commas and enclosed in parentheses. Each suboperand has form identical to an 
operand. The entire sublist including the parentheses is considered one macro instruction 
operand. 

Omitted suboperands have a null value. However, the operand ( ) is considered a character 
string, not a sublist with all the suboperands omitted. The operand limit of 127 characters 
applies to the entire sublist. Examples of valid sublists are: 

(A,2,4,16) Four suboperands 

(A+40,B(2,6),(N,M),240/C+X) Four suboperands 

SUBLISTS IN MODEL STATEMENTS 

In a macro instruction operand, a sublist can assign a set of values to a single symbolic 
parameter of the macro definition. Any model statement may reference the entire symbolic 
parameter, but only a SETA, SETC, or ADO statement can reference the suboperands of the 
symbolic parameter. 

The format used to reference a suboperand is: symbolic parameter (n). 

The subscript n is an arithmetic set expression that refers to the position of the suboperand 
being referenced. For example, &LIST(2) references the second suboperand of the symbolic 
parameter, &LIST. 

If the sublist (A„C20,"192',(N,M)) is a macro instruction operand corresponding to the 
symbolic parameter &FIEL D, the values assigned to the suboperands are: 

FIELD(0) = null 

FIELD(1) = A 

FIELD(2) = null 

FIELD(3) = C20 
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Bulletin: 2202.001-0101 
Date: 3/19/73 



FIELD(4) = '192' 

FIELD(5) = (N,M) 

FIELD{6) through FIELD(n) = null 

A subscripted reference to an omitted sublist element, such as FIELD(2) above, is assigned a 
null value. If the macro instruction operand is a simple operand, rather than a sublist, the 
macro instruction can refer to the operand value by the symbolic parameter without a 
subscript, or by the symbolic parameter with a subscript of 1. All other subscripted 
references have a null value. 

Suboperands of sublists within a sublist (for example, N in FIELD(5) above) cannot be 
referenced in a model statement. 

SUBSTRING NOTATION 

Substring notation allows the programmer to reference part of a macro instruction operand, 
a SET symbol, or a character string constant. Substring notation consists of. a variable 
symbol or a character string constant, immediately followed by two arithmetic set 
expressions separated by a comma and enclosed in parentheses, as in the examples: 

&NAME(2,4) 

C'AB24CFG'(&P1,2) 

The first expression indicates the position of the first character to be included in the 
substring. The second expression indicates the number of consecutive characters (beginning 
with the character indicated by the first expression) to be included in the substring. 

If the substring specifies more characters than are in the macro instruction operand or in the 
character string constant, only the number of available characters are supplied. If the 
starting character is outside the range of the string, a null character is supplied. 

Substring notation has the following limitations: 

1 . Substrings can only be specified for character string constants, macro 
instruction operands, and SET symbols. 

2. A substring of a sublist cannot be specified. 

3. A substring reference can only be used as a term in a conditional 
assembly statement. 

Consider the example in Figure 10-4. 
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Prototype: &LABEL WRITE &P1,8tP2.&P3 
Instruction: .FIRST WRITE 24,C'ABCDE',734A 



Values: &P1 - 24 

&P2<3,3) - ABC 
&P3(1,2) - 73 



Figure 10-4. Examples of Substring Notation 



CONCATENATION OF VARIABLE SYMBOLS 

Variable symbols in model statements can be concatenated so that the name field, operation 
field, or operand field can be modified by a macro instruction. Thus, the mnemonic 
instruction DiV can become DIVA, DIVB, or DIVC, and the operand FIELD can become 
FIELDA, FIELDB, or FIEILDC. 

The example in Figure 10-5 illustrates concatenated operation codes and operands in a 
macro definition. 
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Figure 10-5. Concatenation of Variable Symbols 
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NESTING OF MACROS 

A model statement in a macro definition may be a macro instruction that calls another 
macro. Model statements used as macro instructions are called inner macro instructions. 
Macro instructions not used as model statements are called outer macro instructions. 

Rules for inner macro instructions are the same as for outer macro instructions. Symbolic 
parameters in an inner macro instruction are replaced by the corresponding characters of the 
outer macro instructions. Sublists of an outer macro instruction cannot be passed as a 
sublist to an inner macro instruction. 

An outer macro instruction is a first level macro instruction. The first inner macro 
instruction is a second level instruction, the second inner macro instruction is a third level, 
and so on. Five levels of macro instructions are allowed. Within each level, any number of 
macro instructions may be used. 

Figure 10-6 demonstrates the inner and outer macro instructions and the various levels of 
instructions. 
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Figure 10-6. Nesting of Macros 



MNOTE - GENERATE ERROR MESSAGE 

The MNOTE statement is used only in a macro definition to generate an error message. The 
format of the MNOTE statement is: 



Name 


Operation 


Operand 


Sequence 
symbol or 
blank 


MNOTE 


Severity code, message or 
message only 
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The severity code may be W - warning error, or F - fatal error. If the first character is not a 
W or an F followed by a comma, the statement is treated as a warning error. 

The message may be any EBCDIC characters. The line may not be continued, and no 
substitution is performed. Examples of MNOTE statements are: 



Statement 

MNOTE W,message 
MNOTE F, message 
MNOTE Fmessage 
MNOTE message 



Generated Message 

W MNOTE *message* 
F MNOTE "message* 
W MNOTE * Fmessage* 
W MNOTE * message* 



MEXIT - ALTERNATE TERMINATION FOR MACRO DEFINITION 

The MEXIT statement indicates an alternate termination point for a macro definition. The 
format of the MEXIT statement is: 



Name 



Sequence 
symbol or 
blank 



Operation 



MEXIT 



Operand 



Blank — ignored by the assembler 



When an MEXIT statement is processed, the next statement processed by the assembler is 
the statement immediately following the macro instruction that called the macro. If MEXIT 
is skipped due to conditional assembly, MEXIT is ignored. The MEXIT statement cannot 
replace MEND as the final statement of a macro definition. 

SYSTEM VARIABLE SYMBOLS - &SYSNDX AND &SYSECT 

The system variable symbols, &SYSNDX and &SYSECT, are automatically assigned values 
by the assembler. These symbols can be used only in the name, operation, and operand 
fields of statements in macro definitions. They may not be defined as symbolic parameters, 
nor can they be assigned values by SET statements. 



&SYSNDX 

Assigned an original value of 0001 for the first macro instruction processed, &SYSNDX is 
increased by 1 for each inner or outer macro that is processed. Thus, the value of 
&SYSNDX represents the current number of macro calls processed up to and including the 
current call. 
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The value of &SYSNDX always remains constant within a macro level, regardless of how 
many inner macros are called. When the assembler returns to a given macro (from an inner 
macro), the value of &SYSNDX in effect is the value it had when the macro was first called. 

Figure 10-7 illustrates the changing value of &SYSNDX. The numbers to the left of the 
model statements indicate the value of &SYSNDX as each statement is processed. 

The variable symbol &SYSNDX can be concatenated with other characters to form unique 
names in statements generated from the same model statements. Thus duplicate names can 
be avoided when a macro is called more than once. 

&SYSNDX as an arithmetic term in a SETA expression produces an arithmetic value. In 
other contexts, the value of &SYSNDX is a four digit number, including leading zeros. 

The example in Figure 10-8 shows how &SYSNDX can be used. All statements in the 
example are part of the same macro, which is called by the eighth macro instruction 
processed during the assembly. 

Source 
Program 



READ 



.MACRO 

READ 

Model 
1 Model 
1 Model 

COMPUTE -* 
1 Model 
1 Model 

1 WRITE 

1 Model 
1 Model 

Model 
■MEND 




MACRO 

COMPUTE 

Model 

Model 

Model 

MEND 



END 



-"••MACRO 

WRITE 

3 Model 

3 Model 

3 Model 

MEND 



The numbers to the left of the statements indicate the value of &SYSNDX at that particular 
point in the program. 

Figure 10-7. Using &SYSNDX with Inner and Outer Macros 



Model Statements: 

&SET1 SETA &SYSNDX+10 

&SET2 SETC &SYSNDX 

L&SYSNDX FORM 2,6 



Values: &SYSNDX+10 = 8 + 10 = 18 (in the SETA statement) 
&SYSNDX = 0008 (in the SETC statement) 
L&SYSNDX - L0008 (in the concatenated symbol) 



Figure 10-8. Examples of &SYSNDX 
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&SYSECT 

The variable symbol &SYSECT represents the name of the control section in which a macro 
instruction appears. The value assigned to &SYSECT is the name of the last CSECT or COM 
statement that precedes the current macro instruction. If no CSECT or COM statement 
appears before the macro instruction, &SYSECT has the value of two blanks. 

In any given macro definition, the value of &SYSECT is constant, that is, the name of the 
last CSECT or COM statement before the macro instruction. During nested macro calls, 
&SYSECT in an inner model statement refers to the last active CSECT or COM statement in 
the next outer macro definition. Note the value of &SYSECT in Figure 10-9. 



Source Program 
FIRST COM 



read: 



END 



MACRO 

READ 

Model 

Model 
SCND COM 

SCRIP 
&SYSECT CSECT 

Model 

Model 

MEND 
i 

I 

Value of &SYSECT is FIRST. 

Figure 10-9. Example of &SYSECT 



MACRO 
^"^ SCRIP 
-THRD COM 

Model 
&SYSECT CSECT 
Model 
Model 
MEND 



Value of &SYSECT is SCND. 



CONDITIONAL ASSEMBLY STATEMENTS 

Conditional assembly allows the programmer to specify assembler language statements 
which may or may not be assembled, depending upon conditions evaluated at assembly 
time. These conditions are usually tests of values, which may be defined, set, changed, or 
tested during assembly. Thus, different sequences of statements can be generated from the 
same macro definition. 

Almost all conditional assembly statements can be used inside or outside macros, although 
their primary use is inside macros. The macro language itself can be considered a type of 
conditional assembly. 

The conditional assembly statements are: 

SETA Assigns arithmetic values to set symbols. 

SETC Assigns character values to set symbols. 

GBLA Defines a SETA statement as global. 
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GBLC Defines a SETC statement as global. 

ADO Sets up a source statement generation loop. 

AGO Specifies a branch to another statement; skipped statements 

are not assembled. 

ANOP Specifies an assembly no-operation statement. 



SET STATEMENTS 

The SET statements assign arithmetic and character values to set symbols which can then be 
referenced in subsequent source statements. When the defined symbol appears in a 
subsequent statement, the assembler replaces the symbol with the assigned value. 

If two SET statements assign different values to the same set symbol, the last value assigned 
to the symbol is the value currently in effect. 

SET statements can appear within or outside a macro definition; however, a set symbol 
defined within a macro is local to that macro unless it is specifically declared global. 

A set symbol defined outside a macro can be referenced for its assigned value from 
anywhere in the source program. The same variable symbol may not be used as a symbolic 
parameter and as a set symbol within the same macro definition; nor can the same variable 
symbol be used in a SETA and a SETC statement, if the symbols are defined within the 
same scope. 



SETA - ASSIGN ARITHMETIC VALUE TO SET SYMBOL 

The SETA statement assigns arithmetic values to set symbols. The format of the SETA 
statement is: 



Name 



Set symbol 



Operation 



SETA 



Operand 



Arithmetic set expression 



The set symbol in the name field may not be generated as a result of substitution, that is, 
the name field must be explicitly coded. 

The expression in the operand field is evaluated as a 16-bit arithmetic value which is 
assigned to the set symbol in the name field. 
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An arithmetic set expression may consist of one term or an arithmetic combination of 
terms. The procedure used to evaluate an arithmetic set expression is the same as that used 
to evaluate arithmetic expressions in assembler language statements. The only difference 
between the two expressions lies in the terms that are allowed. The terms that may be used 
in an arithmetic set expression are: 



Arithmetic Terms 

Arithmetic constants 
SETA symbols 
&SYSNDX references 
Count attribute references 
Number attribute references 



Example 

2463 or "F0F2 

&S1 

&SYSNDX 

K'&P1 

N'&P2 



Character Terms 

Symbolic parameters, including 

sublist and substring 

references 
SETC symbols, including 

substring references 
Substrings of character constants 
&SYSECT references 
Character constants 



Example 



&P3(&P1) 

&S 

C'ABCDE'(2,3) 
&SYSECT 
C'ABC 



Any character term except a character constant may appear as a single term, or be used as 
an operand in arithmetic and logical operations, provided the resultant character string 
contains only numeric characters. When used in this context, the value of the character 
string, that is, its decimal equivalent, may not exceed 65,535. 

Any character term may be used as an operand in a relational operation. In this context, the 
term is always treated as a character constant, even if it consists solely of numeric 
characters. 



Since conditional assembly statements represent the tools for source statement generation, 
they cannot themselves be the object of substitution, nor may they be concatenated. For 
example, if the character constant C'&PT appears as a term in an arithmetic set expression, 
its value is &P1 regardless of the actual value of &P1 . 
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The following are examples of valid SETA statements if &P1 and &P2 are symbolic 
parameters with values (64,4,ABC) and AB246C, respectively. 



&S1 


SETA 


8 


&S2 


SETA 


"4A 


&S3 


SETA 


&S1+&S2 


&S4 


SETA 


&P1(1)+&P2(&P1(2),2) 


&S5 


SETA 


(&P1(3)<EQ>C'ABCDE'(1,3)+&P2(4 f 1))/2 


&S6 


SETA 


&P2(3,3) < EQ>C'246'+N'&P1 



Examples of invalid arithmetic set expressions are: 

A+2 Reference to ordinary symbol 



=C'AB' 

2+L'BETA 

&P1(1)<EQ>64 

P*-240' 
C'ABC 
&P1&P2 



Literal term 

Length attribute reference 

&P1 (1 ) is considered a character string, the second 
operand in the relation must be coded as a character 
term, that is, C'64' 

String constant other than a character constant 

Character constant not used in a relation 

Concatenation of symbols 



SETC - ASSIGN CHARACTER VALUE TO SET SYMBOL 

The SETC statement assigns a character value to a set symbol. The assigned character value 
can be passed with the set symbol to another statement operand. The format of the SETC 
statement is: 



Name 


Operation 


Operand 


Set Symbol 


SETC 


Character term or 
arithmetic set expression 



The set symbol in the name field may not be generated as a result of substitution, that is, 
the name field must be explicitly coded. 
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The operand field may contain an arithmetic set expression or one of the following 
character terms: 



Term 

Symbolic parameter, including sublist 
and substring references 

SETC symbol, including substring 
references 

Substring of a character constant 

&SYSECT reference 

Character constant 

&SYSNDX reference 



Example 
&PARM20) 

&SET1 

C'ABCDE'(2,3) 
&SYSECT 
C'ABCD' 
&SYSNDX 



Only one operand is allowed. The maximum size of an assigned character value is 16 bytes. 
If a larger value appears, only the leftmost 16 bytes are assigned by the assembler. 

When &SYSNDX is used as a single character term, the value is a string of four characters, 
including leading zeros. If the operand specified is an arithmetic set expression, the 
arithmetic value is converted to a 16-bit constant. 

Examples of valid SETC operands are: 

C24BK' 
&P1 

&P1 (2,4) 
&P1(&P2(2,1)) 

&SETC 

&SYSECT 

&SYSNDX 

(&SYSNDX+10-&P1(2,4)/2)*&P2(2)<EQ>C'FID' 

Examples of invalid SETC operands are: 

X'1 24' String constant other than a character constant 

C'AB2'+4 Character constant used as arithmetic operand 

ALPHA Ordinary symbol 

L'ALPHA Length attribute 
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GBLA AND GBLC - GLOBAL ARITHMETIC AND CHARACTER SET SYMBOLS 

Local set symbols are made global (available outside the macro) by a GBLA or GBLC 
statement. The format of the GBLA or GBLC statement is: 



Name 


Operation 


Operand 


Blank 


GBLAand 
GBLC 


1-35 set symbols, 
separated by commas 



Global statements must appear immediately after a prototype statement or after another 
global statement. Any number of continuation lines may be used. 

When a set symbol is declared global, its assigned value is available to statements in the main 
program, but not to other macro definitions. To be available to other macro definitions, the 
set symbols must also be declared global in those macro definitions. 

If set symbols have not been assigned values outside this macro definition or by a previous 
call to this definition, the global statement assigns an initial value of to SETA symbols and 
a null character value to SETC symbols. If the set symbols have an assigned value, the global 
statements do not affect the value of the set symbols. 



ADO - ITERATIVE RETURN 

The ADO statement sets up a loop between the ADO statement and a subsequent statement 
identified in the ADO statement. The format of the ADO statement is: 



Name 


Operation 


Operand 


Sequence 
symbol, set 
symbol, or 
blank 


ADO 


Positive arithmetic set 
expression, sequence symbol 



The sequence symbol in the name field can only be referenced by an AGO statement. 

The operand field must have two operands, separated by a comma. The first operand is a 
positive arithmetic set expression that indicates the number of iterations to be executed. 
The second operand is a sequence symbol that specifies the last statement of the loop. This 
sequence symbol must appear in the name field of a statement that follows, not precedes, 
the ADO statement. The sequence symbol cannot be in the name field of another ADO 
statement, a macro instruction, or an AGO statement. 

If the set expression is equal to zero, control is transferred to the statement named in the 
second operand, and no intervening code is included. However, if the first operand is a 
positive number, the assembler subtracts 1 from the first operand and includes in the 
assembly all the code from the ADO statement to the statement named in the second 
operand. If the first operand is zero after the subtraction, the assembler does not return to 
the ADO statement but processes the next statement. If the first operand is not zero after 
the subtraction, the assembler again subtracts 1 from the first operand and repeats the loop. 
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Notice that when the first operand initially is zero, the jump is made to the statement 
named in the second operand. When the first operand is not initially zero, the indicated 
number of loops is performed and a jump is made to the first statement after the statement 
named in the second operand. If the first operand is invalid, the value is set to 1 . 

The name field may contain a sequence symbol, a set symbol, or a blank. If the name field 
contains a set symbol, the symbol is initially assigned a value of 1. For each iteration, this 
value increases by one while the first operand of ADO decreases by one. Thus, in the 
following example, after 10 iterations, the first operand is and &COUNT is 10. 



NAME 




OPERATION 




OPERAND 


12 3 4 5 6 7 8 


9 


10 11 12 13 14 15 16 17 


18 


19 20, 21 22 23 21 25.26 27.28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 


4COUMT 


- 


AD C L. _ 

• ii ii . .» i 




lj£,...&MD. . 








— ■ '--- 


- 




L i .11, i i. ,.i j , ^ L , j , L 



The preceding statement performs a function equivalent to the following three statements. 
During the first iteration, &COUNT equals 1 and the first operand (10) is decreased by one. 
After 10 iterations, &COUNT equals 10 and the first operand equals 0. Control is then 
transferred to the first statement following the .END statement. 



12 3 4 5 6 7 



JCOUHT 

MomE 



OPERATION 



10 11 12 13 14 15 16 17 



SETA 

ADO 

aera... . 



19 20 21 22 23 24 25.26 27 28 29 30 31 32 33 34 35. 36 37 38 39 40 41 42 43 44 45,46 47 48 49 50, 










The ADO statement can be used to include or exclude code from the assembly, depending 
upon the value of the first operand, as in the following example. If the variable symbol 
&LABEL is equal to YES, the first operand of the ADO statement is 1, and all intervening 
code is included in the assembly. If, however, &LABEL is not equal to YES, the first 
operand is zero and all intervening code is excluded. 






10 II 12 13 14 15 16 17 



Anah 



19 20 21 22 23 24 25,26 27 28 29 30, 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45,46 47 48 49 50, 



4kAMl^EA>ilLYE&%^AL 
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NESTING OF ADO STATEMENTS 



As many as six ADO statements can occur within a primary ADO loop. Such nesting of 
ADO statements increases the total number of iterations in geometric progression. If five 
iterations are performed by an outer ADO loop, an inner ADO with five iterations increases 
the number of iterations to 25. An inner ADO statement cannot reference a statement 
outside one referenced by the outer ADO. 

The following statements produce a 5 x 5 matrix containing all products of the ordinary 
numbers 1 through 5. 



OPERATION 



10 11 12 13 14 15 16 17 



13 20 21 22 23 24 28 26 27 28 29 30 31 32 33 34 38 36 37 38 39 40 41 42 43 44 45,46 47 48 49 50, 



IftOJiL 
.Ellfci 



AltCL 
ADCL 

AHOP 



SV.EI4D ... 
teak««JlOJf 



....J i L 



During the first iteration of the outer ADO (named &COL), &COL equals 1 and &ROW 
increases by 1 with each iteration of the &ROW ADO statement until &ROW equals 5. 
During this first iteration, the statement .END WDD &COL *&ROW produces the values 1, 
2, 3, 4, and 5, as shown in the first column of values in this matrix. 

First Pass of the Outer ADO 

&COL 
12 3 4 5 



1 
2 
&ROW 3 
4 
5 



1 
2 
3 
4 
5 



During the second iteration of the outer ADO, &COL equals 2 and &ROW again equals 1 
through 5. The second column of values is produced. 



Second Pass of the Outer ADO 






&COL 




1 


2 3 4 


1 


1 


2 


2 


2 


4 


&ROW 3 


3 


6 


4 


4 


8 


5 


5 


10 
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This process continues until the outer ADO has performed five iterations, at which time the 
5x5 matrix contains the following values: 



&ROW 







&COL 








1 


2 3 


4 


5 


1 


1 


2 3 


4 


5 


2 


2 


4 6 


8 


10 


3 


3 


6 9 


12 


15 


4 


4 


8 12 


16 


20 


5 


5 


10 15 


20 


25 



AGO - UNCONDITIONAL BRANCH 

The AGO statement transfers control to a statement named in its operand field. Statements 
between the AGO statement and the statement to which the jump is made are not included 
in the assembly. The format of the AGO statement is: 



Name 


Operation 


Operand 


Sequence 
symbol or 
blank 


AGO 


Sequence symbol 



The sequence symbol in the operand field must appear in the name field of a statement 
following, not preceding, the AGO statement. An AGO statement can transfer control out 
of an ADO loop. If an AGO statement transfers control into the range of an ADO loop, the 
source statements are processed as if no ADO loop exists. 

The AGO statement cannot jump into or out of a macro. An example of the AGO statement 
appears with the description of the ANOP statement in the following text. 



ANOP- LABEL DEFINITION 

The ANOP statement identifies a statement area to which a jump can be made. Because the 
ANOP statement is used for name field identification only, it has no operands and no 
operation is performed. The format of the ANOP statement is: 



Name 


Operation 


Operand 


Sequence 
symbol 


ANOP 


Not used — ignored 
by the assembler 



If the programmer wants to use an ADO or AGO statement to branch to another statement, 
he must place a sequence symbol in the name field of the statement he wishes to branch to. 
However, if the name field already has an ordinary symbol or a variable symbol, a sequence 
symbol cannot be placed in the name field. To solve this problem, the programmer can place 
an ANOP statement before the statement he wishes to branch to, and branch to the ANOP 
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statement. This arrangement has the same effect as branching to the statement immediately 
after the ANOP statement. 

In Figure 10-10, the AGO statement performs an unconditional branch to the ANOP 
statement. All intervening code is excluded from the assembly. 



12 3 4 5 6 7 



OPERATION 



10 II 12 13 11 15 16 17 



13 20 21 22 23 24 25 2G 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 4E 47 48 49 50 



HERE 



MACKO 



AGO 



ANOP 



HERE 



Figure 10-10. Example of the AGO Statement 



COUNT AND NUMBER ATTRIBUTES 

Count and number attributes are unique to macro instruction operands. These attributes can 
be referred to only in set expressions used as operands in conditional assembly statements 
within macro definitions. 



COUNT ATTRIBUTE 

The count attribute is a value equal to the number of characters in the macro instruction 
operand after substitution of variable symbols in the operand. All characters in the operand, 
including escape characters, are included in this count. If the operand is a sublist, the count 
attribute includes the embracing parentheses and the commas within the sublist. The count 
attribute of an omitted operand is zero. 

If an operand contains variable symbols, the characters that replace the variable symbol, 
rather than the variable symbols, determine the count attribute. 

The notation for the count attribute is K' immediately followed by the symbolic parameter 
that corresponds to the operand. 
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The examples in Figure 10-1 1 illustrate the preceding rules. 





Macro Instruction 


Count 




Symbolic Parameter 


Operand 


Attribute 
K'&PAR 


Count Value 


&PAR 


ALPHA 


5 


&PAR1 


(JUNE,JULY,AUGUST) 


K'&PARI 


18 


&PAR2 


2(10,12) 


K'8tPAR2 


8 


&PAR3 


C'AB#'#3' 


K'&PAR3 


9 



Figure 10-1 1 Examples of the Count Attribute 



To reference the count attribute of a suboperand, K' followed immediately by a subscripted 
symbolic parameter must be used, as in the example: K'&PAR(3). K'&PAR(3) refers to the 
count attribute of the third suboperand of the symbolic parameter &PAR. 



NUMBER ATTRIBUTE 

The number attribute is a value equal to the number of suboperands in an operand sublist. If 
the operand in the macro instruction is not a sublist, the value of the number attribute is 
one. The number attribute of an omitted operand is zero. 

The notation for the number attribute is N' immediately followed by the symbolic 
parameter that corresponds to the operand, as in the example: N'&PAR. 

In the following macro instruction, the count attribute of the operand is 19, while the 
number attribute is 3: 



NAME 




OPERATION 




OPERAND 


12 3 4 5 6 7 8 


9 


10 11 12 13 14 15 16 17 


18 


19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 


_^...^__^-.. ^_ 





REPRO 


" 


CinPDLT ..OUTWIT, LI ST) 









The following example has three operands, each with a number attribute of 1; their count 
attributes, however, are 5, 6, and 4, respectively. 



NAME 




OPERATION 




OPERAND 


12 3 4 5 6 7 8 


9 


10 11 12 13 14 15 16 17 


18 


19 20 21 22 23 24 25 26 27.28 29 30 31 32 33 34 35 36 37 38 39 40.41 42 43 44 45.46 47 48 49 50, 


-— ■ ■ - - 




REPAO 




mPATfXMGTPJIT+LI&T ^ — 
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11. CONTROL LANGUAGE STATEMENTS 



The Control Language for the assembler must provide the following four basic services: 



1. 
2. 
3. 



Call the assembler into execution 
Specify the assembly options 

Define source input, object output, source output, and macro library 
input files 

4. Obtain the source program from the card reader, library member, or 

spooled input 

The Control Language statements for the assembler are explained below. For the exact 
format of the statements, consult the MRX/OS Control Language Services, Extended 
Reference manual. 



Control 

Language 

Statement 

//EXEC PGM= 

//PAR 

//PAR IMEM= 



Parameter 
ASM 
Keyword options 

I nput-member-name 



Description 

Calls the assembler into execution. 

Specifies the assembly options in 
free form. 

Specifies the name of the input source 
module on the library. If omitted, the 
source is assumed to be a non- 
partitioned sequential data file (such 
as a spooled input file). 
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Control 

Language 

Statement 



Parameter 



Description 



//PAR OMEM1 = 



Output-member-name 



//PAR OMEM2= 



Punch-indicator 



Specifies the name of the relocatable 
object module on the library. If 
omitted and OBJECT=YES or COND, 
the assembly is aborted. 

1-10 alphabetic characters to indicate 
that PUNCH output is expected. If 
omitted, no PUNCH output is produced. 



//PAR MAXSIZ= 1-5 decimal digits 



//PAR LIST= 



{YES 

Ino 



//PAR XREF= 



(YES) 
I NO I 



//PAR ERROR= 



YES} 
NO { 



//PAR OBJECT= 




Specifies the approximate number of 
source lines generated in the program. 
If omitted, the default value is the 
SYSGEN parameter, usually 1000. 

Specifies whether the source program is 
to be listed: 

YES List source program 
NO Omit listing 

If omitted, the default parameter is 
YES. 

Specifies whether a cross-reference list 
is to be generated: 

YES Generate cross-reference list 
NO Omit cross reference list 

If omitted, the default parameter is YES. 

Specifies whether warning errors are to 
be listed: 

YES List warning errors 
NO Omit listing 

If omitted, the default parameter is YES. 
Fatal errors are always listed. 

Specifies under what conditions a relocatable 
object module is to be generated: 

YES Module is generated unconditionally 
NO Module is not generated 
COND Module is generated if no fatal 
error occurred 

If omitted, the default parameter is YES. 
If the option, YES or COND, is selected, 
the OMEM1 option must be specified. 
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Control 

Language 

Statement 



Parameter 



Description 



//DEF !D= 



//DEF iD= 



File identifier 



INPUT 



Defines the source input, object output, 
source output, list output, and macro 
library input files. 

Source input file 



//DEF ID= 



//DEF ID= 



//DEF ID= 



//DEF ID= 



OUTPUT1 



OUTPUT2 



LIST 



MAC LIB 

MACLIB1 

MACLIB2 



Relocatable output file: must be 252 
bytes, blocked 1 . The file must be a 
partitioned data file. The device must 
be disc. CSD=YES 

Source punch file identifier: must be 
80 bytes, blocked 1. The file must be 
a non-partitioned sequential data set. 
CSD=YES 

List output file: must be 132 bytes, 
blocked 1 . The file must be a sequential 
data set. CSD=NO. The file is written 
with the first character being a "native" 
mode control character for a printer. 

Macro library input: the files must be 
partitioned data sets, CSD format, 80 
byte records, blocked 1. 



MACLIB9 
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The INPUT and LIST files must always be defined; the OUTPUT1 and OUTPUT2 files are 
optional. //DEFINE statements may also include keyword parameters to identify the file 
name or the device with which the file is associated. 

System macros are cataloged on the $SYSMACLIB file. Additional macro libraries may be 
specified by the user in a hierarchical search. The search is controlled by //DEFINE cards; 
the hierarchy is as follows: 

ID=MACLIB (Highest priority) 

ID=MACLIB1 

ID=MACLIB2 

ID=MACLIB3 

ID=MACLIB4 

ID=MACLIB5 

ID=MACLIB6 

ID=MACLIB7 

ID=MACLIB8 

ID=MACLIB9 (Lowest priority) 

MACLIB is optional; if it is not supplied, the default is $SYSMACLIB, and this file will be 
the highest priority in the search. $SYSMACLIB can be used at a lower priority by 
specifying it as the filename on the //DEFINE card for a lower priority library, and naming 
some other library on the //DEFINE card for ID=MACLIB. The remaining libraries, 
MACLIB1 through MACLI B9, must be specified if they are to be searched, and must appear 
in the order shown above. Any break in the sequence of these libraries terminates the 
search. For example, if cards are supplied in order for MACLI B1, MACLIB2, and MACLI B4, 
the search will terminate with MACLIB2, since MACLIB3 is missing. 

The search is a true hierarchical search; that is, if a macro is called that resides on a low 
priority library, the search for the macro starts at the highest priority library. 

If the source program is to be read from the card reader, the source program card deck must 
be preceded by a //DATA Fl L=SYSCRD statement and be terminated by a /* card. 
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The cards in Figure 11-1 illustrate the Control Language statements to specify: 

• Source input from cards 

• Relocatable output to a specified library member 

• List output to printer 

• Cross-reference output 



//PEF ID«OUTPUT1,FIL=$LIB 
//D EF ID=LIST,DEV=PRINTER 
f //DEF ID-INPUT .DEV-SYSCRD 
//EXEC PGM-ASM 




f //DA TA FIL-SYSCRD 
( // PAR QMEM1=PRG2,XREF=YES 



Figure 1T-1. Example of Control Language Statements 



1 1 -4a 



The cards in Figure 11-2 illustrate the Control Language statements to specify: 
Source input from spooled input file 
Relocatable output to a specified library member 






List output to printer 
Cross-reference output 




Figure 11-2. Example of Control Language Statements 
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The cards in Figure 11-3 illustrate the Control Language statements to specify: 

• Source input from a library file 

• Relocatable output to a specified library member 

• List output to printer 

• Cross-reference output 



Z 



Z 



Z 



Z 



//EOJ 



//PAR OMEM1-PRG2,XREF«YES 



//DEF ID-OUTPUT1,FIL-$LIB 



//DEF ID=LIST,DEV-PRINTER 



(W/DEFID=INPUT,FIL=MYSOURCEFIL,STA-(P,l) 



//EXEC PGM=ASM 



Figure 11-3. Example of Control Language Statements 



To place the intermediate files on non-shared resource discs, any or all of the cards in Figure 
11-4 may be included in the job control stream: 



Z 



z 



z 



z 



z 



//DEF ID=MRELFIL,FIL*=DUMMY,VOL-userpack 



//DEF ID-MRMRGFIL,FIL<=DUMMY,VOL=userpack 



//DEF ID=MRSRTFIL.FIL=DUMMY,VOL-userpack 



//DEF ID-MRTEXT01,FIL-DUMMY,VOL=userpack 



//DEFID=MRVIRTAL.FIL=DUMMY.VOL-userpack 



//DEFID=MRXRFFIL.FIL=DUMMY,VOL=userpack 



Figure 11-4. Placing Files on Disk — Example 
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The file MRTEXT01 has the highest traffic and would be the best candidate for 
performance enhancement. The file MRXRFFIL is used in macro generation and cross 
reference generation programs. The files MRSRTFIL and MRMRGFIL are used for cross 
reference. The file MRVIRTAL is used primarily for symbol table overflow. The file 
MRELFIL is used for error output. 
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A. EBCDIC REPRESENTATION 



EBCDIC 




EBCDIC 




Hex 




Hex 




Code 


Graphic 


Card Code 


Code 


Graphic 


Card Code 


00 


NUL 


12-0-1-8-9 


2F 


BEL 


0-7-8-9 


01 


SOH 


12-1-9 


30 




12-11-0-1-8-9 


02 


STX 


12-2-9 


31 




1-9 


03 


ETX 


12-3-9 


32 


SYN 


2-9 


04 


PF 


12-4-9 


33 




3-9 


05 


HT 


12-5-9 


34 


PN 


4-9 


06 


LC 


12-6-9 


35 


RS 


5-9 


07 


DEL 


12-7-9 


36 


UC 


6-9 


08 




12-8-9 


37 


EOT 


7-9 


09 




12-1-8-9 


38 




8-9 


0A 


SMM 


12-2-8-9 


39 




1-8-9 


OB 


VT 


12-3-8-9 


3A 




2-8-9 


OC 


FF 


12-4-8-9 


3B 




3-8-9 


OD 


CR 


12-5-8-9 


3C 


DC4 


4-8-9 


OE 


SO 


12-6-8-9 


3D 


NAK 


5-8-9 


OF 


SI 


12-7-8-9 


3E 




6-8-9 


10 


DLE 


12-11-1-8-9 


3F 


SUB 


7-8-9 


11 


DC1 


11-1-9 


40 


SP 


No punches 


12 


DC2 


11-2-9 


41 




12-0-1-9 


13 


DC3 


11-3-9 


42 




12-0-2-9 


14 


RES 


11-4-9 


43 




12-0-3-9 


15 


NL 


11-5-9 


44 




12-0-4-9 


16 


BS 


11-6-9 


45 




12-0-5-9 


17 


IL 


11-7-9 


46 




12-0-6-9 


18 


CAN 


11-8-9 


47 




12-0-7-9 


19 


EM 


11-1-8-9 


48 




12-0-8-9 


1A 


CC 


11-2-8-9 


49 




12-1-8 


1B 




11-3-8-9 


4A 


<t 


12-2-8 


1C 


IFS 


11-4-8-9 


4B 


— 


12-3-8 


1D 


IGS 


11-5-8-9 


4C 


< 


12-4-8 


1E 


IRS 


11-6-8-9 


4D 


( 


12-5-8 


1F 


ITB(IUS) 


11-7-8-9 


4E 


H- 


12-6-8 


20 


DS 


11-0-1-8-9 


4F 




12-7-8 


21 


SOS 


0-1-9 


50 


& 


12 


22 


FS 


0-2-9 


51 




12-11-1-9 


23 




0-3-9 


52 




12-11-2-9 


24 


BYP 


0-4-9 


53 




12-11-3-9 


25 


LF 


0-5-9 


54 




12-11-4-9 


26 


EOB/ETB 


0-6-9 


55 




12-11-5-9 


27 


ESC/PRE 


0-7-9 


56 




12-11-6-9 


28 




0-8-9 


57 




12-11-7-9 


29 




0-1-8-9 


58 




12-11-8-9 


2A 


SM 


0-2-8-9 


59 




11-1-8 


2B 




0-3-8-9 


5A 


! 


11-2-8 


2C 




0-4-8-9 


5B 


$ 


11-3-8 


2D 


ENQ 


0-5-8-9 


5C 


* 


11-4-8 


2E 


ACK 


0-6-8^9 


5D 


) 


11-5-8 



A-1 



EBCDIC 




EBCDIC 




Hex 




Hex 




Code 


Graphic 


Card Code 


Code 


Graphic 


Card Code 


5E 


; 


11-6-8 


95 


n 


12-11-5 


5F 




11-7-8 


96 





12-11-6 


60 


- 


11 


97 


P 


12-11-7 


61 


/ 


0-1 


98 


q 


12-11-8 


62 




11-0-2-9 


99 


r 


12-11-9 


63 




11-0-3-9 


9A 




12-11-2-8 


64 




11-0-4-9 


9B 




12-11-3-8 


65 




11-0-5-9 


9C 




12-11-4-8 


66 




11-0-6-9 


9D 




12-11-5-8 


67 




11-0-7-9 


9E 




12-11-6-8 


68 




11-0-8-9 


9F 




12-11-7-8 


69 




0-1-8 


A0 




11-0-1-8 


6A 




12-11 


A1 




11-0-1 


6B 


, 


0-3-8 


A2 


s 


11-0-2 


6C 


% 


0-4-8 


A3 


t 


11-0-3 


6D 


- 


0-5-8 


A4 


u 


11-0-4 


6E 


> 


0-6-8 


A5 


V 


11-0-5 


6F 


? 


0-7-8 


A6 


w 


11-0-6 


70 




12-11-0 


A7 


X 


11-0-7 


71 




12-11-0-1-9 


A8 


y 


11-0-8 


72 




12-11-0-2-9 


A9 


z 


11-0-9 


73 




12-11-0-3-9 


AA 




11-0-2-8 


74 




12-11-0-4-9 


AB 




11-0-3-8 


75 




12-11-0-5-9 


AC 




11-0-4-8 


76 




12-11-0-6-9 


AD 




11-0-5-8 


77 




12-11-0-7-9 


AE 




11-0-6-8 


78 




12-11-0-8-9 


AF 




11-0-7-8 


79 




1-8 


BO 




12-11-0-1-8 


7A 




2-8 


B1 




12-11-0-1 


7B 


# 


3-8 


B2 




12-11-0-2 


7C 


@ 


4-8 


B3 




12-11-0-3 


7D 


' 


5-8 


B4 




12-11-0-4 


7E 


= 


6-8 


B5 




12-11-0-5 


7F 


H 


7-8 


B6 




12-11-0-6 


8,0 




12-0-1-8 


B7 




12-11-0-7 


81 


a 


12-0-1 


B8 




12-11-0-8 


82 


b 


12-0-2 


B9 




12-11-0-9 


83 


c 


12-0-3 


BA 




12-11-0-2-8 


84 


d 


12-0-4 


BB 




12-11-0-3-8 


85 


e 


12-0-5 


BC 




12-11-0-4-8 


86 


f 


12-0-6 


BD 




12-11-0-5-8 


87 


g 


12-0-7 


BE 




12-11-0-6-8 


88 


h 


12-0-8 


BF 




12-11-0-7-8 


89 


i 


12-0-9 


CO 




12-0 


8A 




12-0-2-8 


C1 


A 


12-1 


8B 




12-0-3-8 


C2 


B 


12-2 


8C 




12-0-4-8 


C3 


C 


12-3 


8D 




12-0-5-8 


C4 


D 


12-4 


8E 




12-0-6-8 


C5 


E 


12-5 


8F 




12-0-7-8 


C6 


F 


12-6 


90 




12-11-1-8 


C7 


G 


12-7 


91 


i 


12-11-1 


C8 


H 


12-8 


92 


k 


12-11-2 


C9 


I 


12-9 


93 


I 


12-11-3 


CA 




12-0-2-8-9 


94 


m 


12-11-4 


CB 




12-0-3-8-9 



A-2 



EBCDIC 




EBCDIC 




Hex 




Hex 




Code 


Graphic 


Card Code 


Code 


Graphic 


Card Code 


CC 




12-0-4-8-9 


E6 


W 


0-6 


CB 




12-0-5-8-9 


E7 


X 


0-7 


CE 




12-0-6-8-9 


E8 


Y 


0-8 


CF 




12-0-7-8-9 


E9 


Z 


0-9 


DO 




11-0 


EA 




11-0-2-8-9 


D1 


J 


11-1 


EB 




11-0-3-8-9 


D2 


K 


11-2 


EC 




11-0-4-8-9 


D3 


L 


11-3 


ED 




11-0-5-8-9 


D4 


M 


11-4 


EE 




11-0-6-8-9 


D5 


N 


11-5 


EF 




11-0-7-8-9 


D6 





11-6 


FO 








D7 


P 


11-7 


F1 


1 


1 


D8 


Q 


11-8 


F2 


2 


2 


D9 


R 


11-9 


F3 


3 


3 


DA 




12-11-2-8-9 


F4 


4 


4 


DB 




12-11-3-8-9 


F5 


5 


5 


DC 




12-11-4-8-9 


F6 


6 


6 


DD 




12-11-5-8-9 


F7 


7 


7 


DE 




12-11-6-8-9 


F8 


8 


8 


DF 




12-11-7-8-9 


F9 


9 


9 


EO 




0-2-8 


FA 




12-11-0-2-8-9 


E1 




11-0-1-9 


FB 




12-11-0-3-8-9 


E2 


S 


0-2 


FC 




12-11-0-4-8-9 


E3 


T 


0-3 


FD 




12-11-0-5-8-9 


E4 


U 


0-4 


FE 




12-11-0-6-8-9 


E5 


V 


0-5 


FF 




12-11-0-7-8-9 



A-3 



B. OBJECT FORMATS OF MACHINE INSTRUCTIONS 



The notation used to describe the source and object format in Appendixes A and B is as follows (a = 
absolute, r = relocatable expression). 

Op Code Hexadecimal 00-FF 

R General register, 0-7. (a) 

E Extended register, 0-15. (a) 

M Memory address, 0-65,535. (a or r) 

I Immediate value-airithmetic value, shift count, skip count, or bit number, (a) 

L Field length, 0-255 (for MOVL, 0-65,535). (a) 

( ) Parentheses enclose index registers and field lengths, both of which are optional. 

• A bullet following an instruction name indicates the operands are byte-addressable; other 

operands are word addressable only. 

Bits 8 and 12 of the object instructions are used in almost every instruction to convey information to the 
computer concerning that instruction. If these bits are not interpreted in any way, they are shaded; 
otherwise, the following symbols are used to define bits 8 and 12. 

i Indirect addressing indicator; for direct addressing i=0, for indirect addressing i=1. Indirect 

addressing is indicated by the programmer. 

f A sub-function indicator; indicates a function that the operation code alone cannot do. 

These function bits are set by the assembler. 

1,0 If bit 8 or 12 must be a 1 or a for a particular instruction, the bit will be shown as a 1 or 

0. These bits are set by the assembler; if the wrong bit state appears in the object instruction, 
a no-operation occurs. 



B-1 



TWO BYTE INSTRUCTIONS 



Op 


Mnemonic 




Code 


Code 


Description 


22 


ADDR 


Add Register-Register 


23 


SUBR 


Subtract Register- Register 


29 


DIVR 


Divide Register-Register 


28 


MPYR 


Multiply Register- Register 


25 


ANDR 


Logical Product Register- Register 


26 


EORR 


Exclusive OR Register-Register 


27 


IORR 


Inclusive OR Register-Register 


21 


CMPR 


Compare Register-Register 


20 


MOVR 


Move Register- Register 


24 


INVR 


Inverse Move Register- Register 


6F 


ROFR 


Reverse Off-Bit 


6D 


RONR 


Reverse On-Bit 


6E 


TOFR 


Test for Off-Bit 


6C 


TONR 


Test for On-Bit 


32 


ADDI 


Add Immediate 


33 


SUBI 


Subtract Immediate 


39 


DIVI 


Divide Immediate 


38 


MPYI 


Multiply Immediate 


35 


ANDI 


Logical Product Immediate 


36 


EORI 


Exclusive OR Immediate 


37 


IORI 


Inclusive OR Immediate . 


31 


CMPI 


Compare Immediate 


30 


LODI 


Load Immediate 


34 


INVI 


Inverse Move Immediate 


F5 


INP 


Input from I/O Register 


F6 


OUT 


Output to I/O Register 


81 


INT 


Convert float to fixed 


81 


I NTT 


Convert float to fixed 



Word/Operand 
Format 



7 8 9 11 12 13 15 



Op Code 


i 


«1 


i 


R 2 



Source Operands: @R 1# @R2 



7 8 



11 12 13 15 



two-word 



Op Code 


'1 


i 


R 2 



Source Operands: l-|,@R2 



7 8 



11 12 13 15 



Op Code 


i 


R, 


f 


R 2 



Source Operands: @Ri,R2 



82 


FLT 


Convert fixed to float 


82 


FLTT 


Convert fixed to float 
two-word 



7 8 9 11 12 13 15 



Op Code 


i 


*i 


f 


;■:■:■; : : ■ : &; j ;■: ■: ■ :■: v ;■ ; : ; ■:■ :-S :*: ?$v 



Source Operands: @R-| 



B-2 



Op 


Mnemonic 




Code 


Code 


Description 


5F 


ARDI 


Arithm. Right Double Shift 
Immediate 


4F 


ARSI 


Arithm. Right Single Shift 
Immediate 


5C 


LLDI 


Logical Left Double Shift 
Immediate 


4C 


LLSI 


Logical Left Single Shift 
Immediate 


5D 


LRDI 


Logical Right Double Shift 
Immediate 


4D 


LRSI 


Logical Right Single Shift 
Immediate 


5E 


RLDI 


Rotating Left Double Shift 
Immediate 


4E 


RLSI 


Rotating Left Single Shift 
Immediate 


47 


SRMB 


Skip if Register is Minus 
Backward 


46 


SRMF 


Skip if Register is Minus 
Forward 


43 


SRNB 


Skip if Register Mot Zero 
Backward 


42 


SRNF 


Skip if Register Not Zero 
Forward 


45 


SRPB 


Skip if Register is Plus 
Backward 


44 


SRPF 


Skip if Register is Plus 
Forward 


41 


SRZB 


Skip if Register is Zero 
Backward 


40 


SRZF 


Skip if Register is Zero 
Forward 


3F 


ARDR 


Arithm. Right Double Shift 
By Register 


2F 


ARSR 


Arith. Right Single Shift 
By Register 


3C 


LLDR 


Logical Left Double Shift 
By Register 


2C 


LLSR 


Logical Left Single Shift 
By Register 


3D 


LRDR 


Logical Right Double Shift 
By Register 


2D 


LRSR 


Logical Right Single Shift 
By Register 


3E 


RLDR 


Rotating Left Double Shift 
By Register 


2E 


RLSR 


Rotating Left Single Shift 
By Register 


F2 


DIO 


Disk I/O 


F1 


SIO 


System I/O 



Word/Operand 
Format 



7 8 



11 12 13 15 



Op Code 


■l 


:- : &££:*: 


R 2 



Sou rce Operands : 1 1 , R 2 



7 8 9 11 12 13 15 



Op Code 


' 


R, 




R 2 



Source Operands: @Ri ,R2 



B-3 



Op 
Code 

EB 
2B 



BB 
BA 



13 



Mnemonic 
Code 

BR 
CLDR 



SB 
SF 



SR 



Description 

Branch to Address in Register 
Condition Register Load 



Skip Unconditional Backward 
Skip Unconditional Forward 



4B 


SCFB 


Skip on Condition Register 
False - Back 


49 


SCFF 


Skip on Condition Register 
False - Forward 


4A 


SCTB 


Skip on Condition Register 
True - Back 


48 


SCTF 


Skip on Condition Register 
True ■ Forward 



Service Request 



10 


RBA 


Reset Busy/Active Register 


10 


SBA 


Set Busy/Active Register 


14 


RCN 


Reset Control Register 


14 


SCN 


Set Control Register 


15 


RPM 


Reset Privileged Mode 
Register 


15 


SPM 


Set Privileged Mode Register 


12 


CTB 


Clear Tie-Breaker Register 


11 


TST 


Test and Set Tie-Breaker 



Register 



Word/Operands 
Format 








7 


8 


9 11 


12 


15 


Op Code 


« 


Ri 





Source Operands: @R^ 



7 


8 15 


Op Code 


'1 



Source Operands: lj 






7 


8 




11 


12 




15 


Op Code 


H 


'2 



Source Operands: 1^,1 2 



7 8 



Source Operand: @l<| 



15 



Op Code 


i 


'1 



7 8 9 11 12 13 15 



Op Code 


i 


Rv'1 


f 


'2 



Source Operands: @Ri,l2 or I1J2 








7 


8 




11 


12 


15 


Op Code 


'1 


lliilil 


J|;;s|||g||j::-j| 



Source Operand: l-j 



B-4 



Op 
Code 



Mnemonic 
Code 



Description 



Word/Operand 
Format 



EF 


BCM 


Branch to Control Memory 


F4 


WRC 


Communications Output 
Command 



FO 
FO 



F3 
80 



RDX 
WRX 



RDC 

NEGF 



2A 
3A 



CSTR 
PSTR 



Read Extended Register 
Write Extended Register 



Communications I/O 
Negate Floating Point 



Condition Register Store 
Program Address Store 



7 8 9 11 12 13 15 



Op Code 




«1 




R 2 



Source Operands: R-|,R2 



7 8 



11 12 13 15 



Op Code 


E 1 


f 


R 2 



Source Operands: E^,R2 



7 


8 15 


Op Code 


[: jjiE^Ej: j^T j|: |H j|> : : : : ji= ■: = :H: :: j::^-:: = := 1=^^:^:^ j ^l^ ^>::[:H|![:1; jIlU :|:Ul :|: -H ::U:i:!UH::U::iH: H=: =: H=: : 1= ih^lh^l =1= : 



Source Operands: none 








7 


8 


11 


12 


13 15 


Op Code 


ilMi^^Hill 


i 


«1 



Source Operand: @R-| 



B-5 



FOUR BYTE INSTRUCTIONS 



Op 


Mnemonic 




Code 


Code 


Description 


A2 


ADD 


Add 


72 


ADDT 


Add Two-Word 


A3 


SUB 


Subtract 


73 


SUBT 


Subtract Two- Word 


A9 


DIV 


Divide 


A8 


MPY 


Multiply 


A5 


AND 


Logical Product 


A6 


EOR 


Exclusive OR 


A7 


IOR 


Inclusive OR 


F9 


CBY 


Compare Byte • 


A1 


CMP 


Compare 


71 


CMPT 


Compare Two-Word 


AO 


LOD 


Load, Memory- Register 


F7 


LODB 


Load Byte Memory-Register • 


70 


LODT 


Load Two-Word 


FA 


STO 


Store Register-Memory 


F8 


STOB 


Store Byte Register-Memory • 


FB 


STOT 


Store Two-Word 


A4 


INV 


Inverse Move Memory- Register 


E4 


BA1 


Branch Add 1 


E5 


BA2 


Branch Add 2 


E1 


BRN 


Branch if Register is Not Zero 


E0 


BRZ 


Branch if Register is Zero 


E6 


BS1 


Branch Subtract 1 


E7 


BS2 


Branch Subtract 2 


EA 


BSR 


Branch and Save Return 


EE 


NOP 


No Operation 



Word/Operand 
Format 








7 


8 


9 11 


12 


13 15 


Op Code 


i 


Ri 


i 


«2 


M 1 



Source Operands: @M-|(Ri>,@R2 



B2 ADDD Add Direct 

B3 SUBD Subtract Direct 

B9 DIVD Divide Direct 

B8 MPYD Multiply Direct 

B5 ANDD Logical Product Direct 

B6 EORD Exclusive OR Direct 

B7 IORD Inclusive OR Direct 

B1 CMPD Compare Direct 

BO LODD Load Direct 

B4 INVD Inverse Move Direct 

84 LODF Load floating point 
86 ADDF Add floating point 

85 SUBF Subtract floating point 

88 MPYF Multiply floating point 

89 DIVF Divide floating point 








7 


8 


9 11 


12 


13 15 


Op Code 


111 


«1 


i 


R 2 


'1 



Source Operands: l-| (R-(),@R2 








7 


8 


9 11 


12 


13 15 


Op Code 


i 


Ri 


liijiii&S: 


R 2 


M t 



Source Operands: @M^(Ri),R2 



B-6 



Op 


Mnemonic 




Code 


Code 


Description 


E9 


BCF 


Branch on Condition 
Register - False 


E8 


BCT 


Branch on Condition 
Register - True 


E2 


BOF 


Branch if Bit is Off 


E3 


BON 


Branch if Bit is On 



Word/Operand 
Format 








7 


8 


9 11 


12 




15 


Op Code 


i 


R, 


'2 


M 1 



Source Operands: ©M-jfR^,^ 



AA 


CVB 


Convert to Binary • 


AA 


CVBT 


Convert to Binary 
Two-Word o 


AB 


CVD 


Convert to Decimal • 


AB 


CVDT 


Convert to Decimal 
Two-Word • 



BF 


IBIT 


Invert Bit • 


BD 


RBIT 


Reset Bit • 


BC 


SBIT 


Set Bit 9 


BE 


TBIT 


Test Bit • 



ED 
EC 


B 
BCH 


Branch-Post Indexing 
Branch-Pre Indexing 


87 
8A 


CMPF 
STOF 


Compare floating point 
Store floating point 








7 


8 


9 11 


12 


13 15 


Op Code 


i 


Ri 


f 


R 2 


M 1 



Source Operands: @Mi(R 1 ),R 2 






7 


8 


9 11 


12 


13 15 


Op Code 


i 


R, 


1 


'2 


M 1 



Source Operands: @M<|(R<|),l2 








7 


8 


9 11 


12 


15 


Op Code 


i 


Ri 






M 1 



Source Operands: @Mi(Ri> 



FE 


RAR 


Read Any Register 


FE 


WAR 


Write Any Register 


FF 


RSAR 


Restore All Registers 


FF 


SAR 


Save All Registers 


FD 


RRO 


Read Register Options 


FD 


WRO 


Write Register Options 








7 


8 


9 11 


12 


13 15 


Op Code 


f 


Ri 


i 


R 2 


'1 



Source Operands: l-| (R-| ),@R2 



B-7 



SIX BYTE INSTRUCTIONS 



Op 


Mnemonic 




Code 


Code 


Description 


62 


ADDM 


Add Memory-Memory 


63 


SUBM 


Subtract Memory-Memory 


69 


DIVM 


Divide Memory-Memory 


68 


MPYM 


Multiply Memory-Memory 


65 


AN DM 


Logical Product Memory- 
Memory 


66 


EORM 


Exclusive OR Memory- 
Memory 


67 


IORM 


Inclusive OR Memory- 
Memory 


6B 


CBYM 


Compare Byte Memory- 
Memory • 


61 


CMPM 


Compare Memory-Memory 


6A 


MOVB 


Move Byte Memory-Memory 


60 


MOVM 


Move Word Memory-Memory 


64 


INVM 


Inverse Move Memory- 
Memory 



Word/Operand 
Format 








7 


8 


9 11 


12 


13 15 


Op Code 


i 


"i 


i 


R 2 


M 1 


M 2 



Source Operands: @Mi(Ri),@M 2 (R2) 



3B 



SHFK 



Shift Packed Decimal 



7 8 9 11 12 13 15 



Op Code 




Ri 


■SsSIsi:! 


R 2 


M 2 


"-1 


'2 



Source Operands: Mi(Li,Ri),l 2 (R 2 ) 



B-8 



EIGHT BYTE INSTRUCTIONS 



Op Mnemonic 
Code Code Description 



52 


ADDK 


53 


SUBK 


51 


CMPK 


55 


CMPX 


54 


MOVX 


58 


PAKX 


59 


UNPX 


50 


ZADK 


57 


EDTX 


7C 


DIVK 


5B 


MPYK 



Add Packed Decimal • 
Subtract Packed Decimal • 
Compare Packed Decimal • 
Compare Characters • 
Move Characters • 
Pack • 
Unpack • 

Zero and Add Decimal • 
Packed Decimal/Alpha 

Edit • 
Divide Packed Decimal • 
Multiply Packed Decimal • 



Word/Operand 
Format 



7 8 9 11 12 13 15 



Op Code 




Ri 




R 2 




M 


1 








M 


2 






Li 






L 2 





Source Operands: Mi<l_i,Ri),M2(l-2,R2) 



56 



5A 



TRNX 



MOVL 



Translate • 



Move Long • 



7 8 9 11 12 13 15 



Op Code 


111 


R 1 


:'-.- mj.'.' ; 


R 2 


M 1 


M 2 




L 2 



Source Operands: M-j(Ri),M 2 (L 2 ,R 2 ) 








7 


8 


9 11 


12 


13 15 


Op Code 


III 


R, 




R 2 


M-, 


M 2 


Li 



Source Operands: M-|(Li,Ri),M 2 (R 2 ) 
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C. ALPHABETICAL LIST OF MNEMONICS 



This appendix lists all machine mnemonic codes and extended mnemonic codes in alphabetical order. Also 
included are the hexadecimal function codes, the instruction size in bytes, and the configuration of the 
source operand. An asterisk in the function code column indicates an extended mnemonic code. The 
symbols used in the operand configuration are the same as in the preceding lists. 



Mnemonic 


Operation 


Instruction 




Code 


Code 
A2 


Size (Bytes) 
4 


Operand Configuration 


ADD 


@Mi(R 1 ),@R 2 


ADDD 


B2 


4 


ll(R 1 ),@R 2 


ADDF 


86 


4 


@M 1 (Ri),R 2 


ADDI 


32 


2 


l 1f @R 2 


ADDK 


52 


8 


M 1 (L 1 ,R 1 ),M 2 (L 2 ,R 2 ) 


ADDM 


62 


6 


@Ml(Ri>,@M 2 (R 2 ) 


ADDR 


22 


2 


@R 1# @R 2 


ADDT 


72 


4 


@M 1 (R 1 ),@R 2 


AND 


A5 


4 


@M 1 (R 1 ),@R 2 


ANDD 


B5 


4 


l 1 (R-|),@R 2 


ANDI 


35 


2 


l 1f @R 2 


ANDM 


65 


6 


@M 1 (R 1 ),@M 2 (R 2 ) 


ANDR 


25 


2 


@R 1( @R 2 


ARDI 


5F 


2 


'1.F?2 


ARDR 


3F 


2 


@R 1# R 2 


ARSI 


4F 


2 


'1' R 2 


ARSR 


2F 


2 


@Rl,R 2 


B 


ED 


4 


©M^Rq) 


BA1 


E4 


4 


@Mi(R 1 ),@R 2 


BA2 


E5 


4 


@M 1 (R-|),@R 2 


BBR 


* 




(DM^R.,) 


BBS 


* 




@M 1 (R-, ) 


BCF 


E9 


4 


©M^R-i),^ 


BCH 


EC 


4 


©M^R-,) 


BCM 


EF 


2 


R^,R 2 


BCT 


E8 


4 


@IN/I 1 (R 1 ),I 2 


BCY 


* 




©M^Rt) 


BEQ 


* 




©M^R-,) 


BGE 


* 




©M^R,) 


BGT 


* 




@M i ( R 1 ) 


BID 


* 




@M 1 (R-|) 


BKM 


* 




©M^R-,) 


BKP 


* 




©M^R.,) 


BKZ 


* 




©M^R^ 


BLE 


* 




@M- l (R^) 


BLEQ 


* 




(sWl^R^ 


BLGE 


* 




©M^R^ 



C-1 



Mnemonic 


Operation 


Instruction 




Code 


Code 


Size (Bytes) 


Operand Configuration 


BLGT 


* 




©M^R,) 


BLLE 


# 




©M^R^ 


BLLT 


* 




©M^Ri) 


BLNE 


# 




@M } {^ 1 ) 


BIT 


* 




@M 1 (R 1 ) 


BNC 


* 




@M-](R 1 ) 


BNE 


* 




©M^R-,) 


BNI 


# 




©M^R,) 


BNV 


* 




@M 1 (R 1 ) 


BOF 


E2 


4 


©M^R^,^ 


BON 


E3 


4 


@M^R]),\ 2 


BOV 


* 




©M^R.,) 


BR 


EB 


2 


@Rt 


BRN 


E1 


4 


@M 1 (R 1 ),@R 2 


BRZ 


EO 


4 


@M 1 (R 1 ),@R 2 


BS1 


E6 


4 


@M 1 (R 1 ),@R 2 


BS2 


E7 


4 


@M 1 (R 1 ),@R 2 


BSR 


EA 


4 


@M-|(R-|),@R 2 


CBY 


F9 


4 


@M 1 (R 1 ),@R 2 


CBYM 


6B 


6 


@M 1 (R 1 ) r @M 2 (R 2 ) 


CLDR 


2B 


2 


@R 1 


CMP 


A1 


4 


@M-|(R 1 ),@R 2 


CMPD 


B1 


4 


ll(R 1 ),@R 2 


CMPF 


87 


4 


©M^R,} 


CMPI 


31 


2 


l 1# @R 2 


CMPK 


51 


8 


M 1 (L 1 ,R 1 ),M 1 (L 2 ,R 2 ) 


CMPM 


61 


6 


@M-|(R 1 ),@M 2 (R 2 ) 


CMPR 


21 


2 


@R 1r @R 2 


CMPT 


71 


4 


@M 1 (Ri),@R 2 


CMPX 


55 


8 


M 1 (L 1 ,R 1 ),M 2 (L 2 ,R 2 ) 


CSTR 


2A 


2 


@R 1 


CTB 


12 


2 


'1 


CVB 


AA 


4 


@M 1 (R 1 ),R 2 


CVBT 


AA 


4 


@M.|(Ri),R2 


CVD 


AB 


4 


@M 1 (R 1 ),R 2 


CVDT 


AB 


4 


@Mi(R 1 ),R 2 


DIO 


F2 


2 


@R 1r R 2 


DIV 


A9 


4 


@Mi<R 1 ),@R 2 


DIVD 


B9 


4 


l 1 (R 1 ),@R 2 


DIVF 


89 


4 


@M 1 (Ri),R 2 


DIVI 


39 


2 


l 1# @R 2 
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Mnemonic 


Operation 


Instruction 




Code 


Code 


Size (Bytes) 
8 


Operand Configuration 


DIVK 


7C 


M 1 (L 1 ,R 1 ),M 2 (L 2 .R2) 


DIVM 


69 


6 


@IVI 1 (R 1 ),@M2(R2) 


DIVR 


29 


2 


@Rl,@R 2 


EDTX 


57 


8 


M 1 (L 1 ,R 1 ),M 2 (L 2 ,R2) 


EOR 


A6 


4 


@M 1 (R 1 ),@R 2 


EORD 


B6 


4 


l- ) <R 1 ),@R 2 


EORI 


36 


2 


l-|,@R 2 


EORM 


66 


6 


@M 1 (R 1 ),@M 2 (R 2 ) 


EORR 


26 


2 


@R 1r @R 2 


FLT/FLTT 


82 


2 


@Rt 


IBIT 


BF 


4 


©M^R^.12 


INP 


F5 


2 


ll,@R 2 


INT/I NTT 


81 


2 


@Rl,R 2 


INV 


A4 


4 


@M 1 (R 1 ),@R 2 


INVD 


B4 


4 


l 1 (R 1 ),@R 2 


INVI 


34 


2 


l 1( @R 2 


IIWM 


64 


6 


@Mi(R 1 ),@M 2 (R 2 ) 


INVR 


24 


2 


@R 1f @R 2 


IOR 


A7 


4 


@M 1 (Ri),@R 2 


IORD 


B7 


4 


l 1 (R 1 ),@R 2 


IORI 


37 


2 


l 1f @R 2 


IORM 


67 


6 


@M 1 (R 1 ),@M 2 (R 2 ) 


IORR 


27 


2 


@R-j,@R 2 


LLDI 


5C 


2 


l 1f R 2 


LLDR 


3C 


2 


@R 1r R 2 


LLSI 


4C 


2 


l v R 2 


LLSR 


2C 


2 


@R 1# R 2 


LOD 


AO 


4 


@M 1 (R 1 ),@R 2 


LODB 


F7 


4 


@Mi(R-|),@R 2 


LODD 


BO 


4 


l 1 (R 1 ),@R 2 


LODF 


ES4 


4 


@M 1 (R 1 ),R 2 


LODI 


30 


2 


ll,@R 2 


LODT 


70 


4 


@M 1 (R 1 ),@R 2 


LRDI 


5D 


2 


l 1( R 2 


LRDR 


3D 


2 


@Rl,R 2 


LRSI 


4D 


2 


■l* R 2 


LRSR 


2D 


2 


@R 1( R 2 


MOVB 


6A 


6 


@M 1 (Ri),@M 2 (R 2 ) 


MOVL 


5A 


8 


M 1 (L 1 ,R 1 ),M 2 (R 2 ) 


MOVM 


60 


6 


@M 1 (R 1 ),@M 2 (R 2 ) 


MOVR 


20 


2 


@Rl,@R 2 
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Mnemonic 


Operation 


Instruction 




Code 


Code 
54 


Size (Bytes) 
8 


Operand Configuration 


MOVX 


. M 1 (L 1 .R 1 ).M 2 (L 2 .R2» 


MPY 


A8 


4 


@M 1 (R 1 ),@R 2 


MPYD 


B8 


4 


l 1 (R 1 ),@R 2 


MPYF 


88 


4 


@M 1 (R 1 ),R 2 


MPYI 


38 


2 


l-|,@R 2 


MPYK 


5B 


8 


M 1 (L 1 ,R 1 ),M 2 (L 2 ,R 2 ) 


MPYM 


68 


6 


@M 1 (R 1 ),@M 2 (R 2 ) 


MPYR 


28 


2 


@R 1# @R 2 


NEGF 


80 


2 


blank 


NOP 


EE 


4 


blank or @M 1 (R 1 ),@R 2 


OUT 


F6 


2 


l v @R 2 


PAKX 


58 


8 


M l (L 1 ,Ri).M 2 <L 2 .R2) 


PSTR 


3A 


2 


@R- l 


RAR 


FE 


4 


M 1 (R 1 ),@R 2 


RBA 


10 


2 


@R-|,l 2 or li # l 2 


RBIT 


BD 


4 


©M^R^.12 


RCN 


14 


2 


@R 1f l 2 or l|,l 2 


RDC 


F3 


2 




RDX 


FO 


2 


E 1f R 2 


RLDI 


5E 


2 


'1< R 2 


RLDR 


3E 


2 


@R 1( R 2 


RLSI 


4E 


2 


'1.R2 


RLSR 


2E 


2 


@Rl,R 2 


ROFR 


6F 


2 


@R 1# @R 2 


RONR 


6D 


2 


@R 1# @R 2 


RPM 


15 


2 


@Rl,l 2 or l-|,l 2 


RRO 


FD 


4 


M 1 (R 1 ),@R 2 


RSAR 


FF 


4 


M 1 (R. ) ),@R 2 


S 


* 




M^ or I1 


SAR 


FF 


4 


M 1 (R 1 ),@R 2 


SB 


BB 


2 


'1 


SBA 


10 


2 


@R 1( l 2 or li,l 2 


SBIT 


BC 


4 


@M 1 (R 1 ),I 2 


SBR 


* 




M-\ or l-| 


SBS 


* 




Ml or l<| 


SCF 


* 




M 1# l 2 or l lf l 2 


SCFB 


4B 


2 


>1.'2 


SCFF 


49 


2 


I1.I 2 


SCN 


14 


2 


@Rl # l 2 or l-j,l 2 


SCT 


* 




M 1r l 2 or l-|,l 2 


SCTB 


4A 


2 


'l.'2 
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Mnemonic 


Operation 


Instruction 




Code 


Code 


Size (Bytes) 
2 


Operand Configuration 


SCTF 


48 


■l.'2 


SCY 


* 




Ml or l-| 


SEQ 


# 




Mi or 1 ■] 


SF 


BA 


2 


'1 


SGE 


tt 




M-| or l^ 


SGT 


* 




M^ or li 


SHFK 


3B 


6 


M 1 (L 1 ,R 1 ),I 2 (R 2 > 


SID 


# 




Mi or l-j 


SIO 


F1 


2 


@R-|,R2 


SKM 


tt 




Mi or li 


SKP 


«• 




Mi or li 


SKZ 


# 




M-j or l-j 


SLE 


« 




Mi or li 


SLEQ 


tt 




M-| or l-j 


SLGE 


# 




M-| or l-| 


SLGT 


# 




Mi or l"| 


SLLE 


# 




Mi or li 


SLLT 


tt 




Mi or !•) 


SLNE 


# 




M-j or !•) 


SLT 


# 




M^ or 1 1 


SNC 


4t 




Mi or I-) 


SNE 


tt 




M-j or !■) 


SNI 


* 




M-j or li 


SNV 


# 




Mi or li 


SOV 


•fc 




M-| or I-) 


SPM 


15 


2 


@R-|,l2 or 'l''2 


SR 


13 


2 


@l 1 


SRM 


# 




Mi # R2or I -|,R2 


SRMB 


47 


2 


l 1f R 2 


SRMF 


46 


2 


•l- R 2 


SRN 


* 




Mi,R2 or I1J2 


SRNB 


43 


2 


Il.l2 


SRNF 


42 


2 


l 1f R 2 


SRP 


■* 




Mi,R2 or 1 1 ,1 2 


SRPB 


45 


2 


l 1( R 2 


SRPF 


44 


2 


l lf R 2 


SRZ 


* 




M-j,R2 or I1J2 


SRZB 


41 


2 


l 1( R 2 


SRZF 


40 


2 


l 1# R 2 


STO 


FA 


4 


@M 1 (R 1 ),@R 2 


STOB 


!F8 


4 


@M-i(R 1 ),@R2 
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Mnemonic 


Operation 


Instruction 




Code 


Code 


Size (Bytes) 
4 


Operand Configuration 


STOF 


8A 


©M^R^ 


STOT 


FB 


4 


@M 1 (R 1 ),@R 2 


SUB 


A3 


4 


@M 1 (R 1 ),@R 2 


SUBD 


B3 


4 


l 1 (R 1 ),@R 2 


SUBF 


85 


4 


@M 1 (R 1 ),R 2 


SUBI 


33 


2 


l-|,@R 2 


SUBK 


53 


8 


M 1 (L 1 ,R 1 ),IVl2(L 2 ,R 2 ) 


SUBM 


63 


6 


@M 1 (Ri),@M 2 (R 2 ) 


SUBR 


23 


2 


@R 1# @R 2 


SUBT 


73 


4 


@M 1 (R 1 ),@R 2 


TBIT 


BE 


4 


@M 1 (R 1 ),I 2 


TOFR 


6E 


2 


@R 1# @R 2 


TONR 


6C 


2 


@R-|,@R 2 


TRNX 


56 


8 


M 1 (R 1 ),M 2 (L 2 ,R 2 ) 


TST 


11 


2 


'1 


UNPX 


59 


8 


M 1 (L 1 ,R 1 ),M 2 (L 2 ,R 2 ) 


WAR 


FE 


4 


M. ] (R 1 ),@R 2 


WRC 


F4 


2 


R 1' R 2 


WRO 


FD 


4 


M 1 (R 1 ),@R 2 


WRX 


FO 


2 


E 1f R 2 


ZADK 


50 


8 


M 1 (L 1 ,R 1 ),M 2 (L 2 ,R 2 ) 
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D. HEX CODE TO MNEMONIC CODE 



10 


SBA/RBA 


42 


SRNF 


6A 


MOVB 


B7 


IORD 


11 


TST 


43 


SRNB 


6B 


CBYM 


B8 


MPYD 


12 


CTB 


44 


SRPF 


6C 


TONR 


B9 


DIVD 


13 


SR 


45 


SRPB 


6D 


RONR 


BA 


SF 


14 


SCN/RCN 


46 


SRMF 


6E 


TOFR 


BB 


SB 


15 


SPM/RPM 


47 


SRMB 


6F 


ROFR 


BC 


SBIT 


20 


MOVR 


48 


SCTF 


70 


LODT 


BD 


RBIT 


21 


CMPR 


49 


SCFF 


71 


CMPT 


BE 


TBIT 


22 


ADDR 


4A 


SCTB 


72 


ADDT 


BF 


IBIT 


23 


SUBR 


4B 


SCFB 


73 


SUBT 


EO 


BRZ 


24 


. INVR 


4C 


LLSI 


7C 


DIVK 


E1 


BRN 


25 


ANDR 


4D 


LRSI 


80 


NEGF 


E2 


BOF 


26 


EORR 


4E 


RLSI 


81 


I NT/I NTT 


E3 


BON 


27 


IORR 


4F 


ARSI 


82 


FLT/FLTT 


E4 


BA1 


28 


MPYR 


50 


ZADK 


84 


LODF 


E5 


BA2 


29 


DIVR 


51 


CMPK 


85 


SUBF 


E6 


BS1 


2A 


CSTR 


52 


ADDK 


86 


ADDF 


E7 


BS2 


2B 


CLDR 


53 


SUBK 


87 


CMPF 


E8 


BCT 


2C 


LLSR 


54 


MOVX 


88 


MPYF 


E9 


BCF 


2D 


LRSR 


55 


CMPX 


89 


DIVF 


EA 


BSR 


2E 


-RLSR 


56 


TRNX 


8A 


STOF 


EB 


BR 


2F 


ARSR 


57 


EDTX 


AO 


LOD 


EC 


BCH 


30 


LODI 


58 


PAKX 


A1 


CMP 


ED 


B 


31 


CMPI 


59 


UNPX 


A2 


ADD 


EE 


NOP 


32 


ADDI 


5A 


MOVL 


A3 


SUB 


EF 


BCM 


33 


SUBI 


5B 


MPYK 


A4 


INV 


FO 


RDX/WRX 


34 


INVI 


5C 


LLDI 


A5 


AND 


F1 


SIO 


35 


ANDI 


5D 


LRDI 


A6 


EOR 


F2 


DIO 


36 


EORI 


5E 


RLDI 


A7 


IOR 


F3 


RDC 


37 


IORI 


5F 


ARDI 


A8 


MPY 


F4 


WRC 


38 


MPYI 


60 


MOVM 


A9 


DIV 


F5 


INP 


39 


DIVI 


61 


CMPM 


AA 


CVB/CVBT 


F6 


OUT 


3A 


PSTR 


62 


ADDM 


AB 


CVD/CVDT 


F7 


LODB 


3B 


SHFK 


63 


SUBM 


BO 


LODD 


F8 


STOB 


3C 


LLDR 


64 


INVM 


81 


CMPD 


F9 


CBY 


3D 


LRDR 


65 


ANDM 


B2 


ADDD 


FA 


STO 


3E 


RLDR 


66 


EORM 


B3 


SUBD 


FB 


STOT 


3F 


ARDR 


67 


IORM 


B4 


INVD 


FD 


RRO/WRO 


40 


SRZF 


68 


MPYM 


B5 


ANDD 


FE 


RAR/WAR 


41 


SRZB 


69 


DIVM 


B6 


EORD 


FF 


SAR/RSAR 
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E. SUMMARY OF ASSEMBLER STATEMENTS 



Name 


Operation 


Operand 


Sequence symbol, set symbol, 
or blank 


ADO 


Arithmetic set expression, 
sequence symbol 


Sequence symbol or blank 


AGO 


Sequence symbol 


Symbol or blank 


ALIGN 


Absolute, resolved arithmetic 
expression 


Sequence symbol 


ANOP 


Not used — ignored by the 
assembler 


Symbol or blank 


BDD 


One or more operands 
separated by commas 


Symbol or blank 


BRS 


Absolute, arithmetic 
expression 


Symbol or blank 


COM 


Not used — ignored by the 
assembler 


Symbol or blank 


CSECT 


Not used — ignored by the 
assembler 


Sequence symbol or blank 


EJECT 


Not used — ignored by the 
assembler 


Blank 


END 


Ordinary symbol or blank 


Sequence symbol or blank 


ENTRY 


One or more relocatable symbols 
separated by a comma 


Ordinary or variable symbol 


EQU 


Expression 


Sequence symbol or blank 


EXTRN 


One or more relocatable symbols 
separated by a comma 


Ordinary symbol 


FORM 


One or more positive arithmetic 
expressions separated by commas 


Symbol or blank 


Form name 


Exp,exp,. . .,exp 


Blank 


GBLA 


1-35 set symbols separated by 
commas 


Blank 


GBLC 


1 -35 set symbols separated by 
commas 


Blank 


ICTL 


Two decimal arithmetic constants 
separated by a comma 
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Name 


Operation 


Operand 


Blank 


ISEQ 


Blank, or two decimal arithmetic 
constants separated by a comma 


Symbol or blank 


LTORG 


Not used 


Blank 


MACRO 


Not used — ignored by the 
assembler 


Sequence symbol or blank 


MEND 


Not used — ignored by the 
assembler 


Sequence symbol or blank 


MEXIT 


Not used — ignored by the 
assembler 


Sequence symbol or blank 


MNOTE 


Severity code, message or 
message only 


Sequence symbol or blank 1 ORG 


Relocatable expression or blank 


Sequence symbol or blank 


PRINT 


One-to-four operands separated 
by commas 


Sequence symbol or blank 


PUNCH 


Not used 


Set symbol 


SETA 


Arithmetic set expression 


Set Symbol 


SETC 


Character term or arithmetic 
set expression 


Sequence symbol or blank 


SPACE 


Absolute arithmetic expression 


Symbol or blank 


TITLE 


Character string constant 


Symbol or blank 


WDD 


One or more operands separated 
by commas 


Symbol or blank 


WRS 


Absolute arithmetic expression 
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F. MACRO EXAMPLE 



The example in Figures F-1 through F-3 demonstrates the use of the FORM instruction, but 
may serve as a model for many macro language and conditional features. It shows the 
comprehensive definition for a system macro, and two MACRO instructions for that macro. 
Two are included because the definition generates some code unique to the first call. 

The formal parameter list of the definition identifies expected parameters from the call: 
IDENT, LABDEF, REWIND, USAGE, CONTROL, and LIST. Three of these (REWIND, 
USAGE, and CONTROL) have default values provided in the definition. The other three 
remain null in value, if the call does not provide an explicit value for them. 

By using relational expressions in SETA statements, the macro definition provides for the 
setting of many counters according to the parameter values provided. Hence, the first call in 
the example, whose parameter string is: IDENT=FILE1,USAGE=0, sets the counter &UO 
(line 00039) because USAGE=0 was coded. 

Because of the default value YES for REWIND, counter &RY (line 00042) is also set. The 
default ANS for CONTROL sets counter &CCA (line 00045). Conversely, counters &LY 
(line 00021 ), &LN (line 00025), and &LB (line 00037) are zero, because the LABDEF and 
LIST parameters were not given values by the macro call. 

Note how the definition explicitly checks for failure to provide the IDENT parameter (lines 
00048-00053). If the user does not provide it in the call, its count is zero (K'&IDENT), 
&IDNO is set to 1, and the ADO statement (line 00050) generates the fatal MNOTE 
message. In the call examples, IDENT=FILE1, the count (K'&IDENT) is 5 and &IDNO is 
not set. By similar means, the definition checks to ensure that specifications for the other 
parameters are correct. 

When all the incoming parameter values are verified and the appropriate conditional 
counters are set or reset, the macro generates the I/O packet with a FORM statement to 
designate the principal options. 

In line 00003, the macro declares the count field (&DMOCCNT) as global, and tests it for a 
zero (default) value. If it is zero, line 00005 sets it to 1. In this way, the macro determines 
whether the call is the first call within the assembly. This allows the once-only definition of 
the FORM instruction: $DMFRM, consisting of eight one-bit fields (line 00007). (Also note 
the use of the same code to generate an external for $DMOCC (line 00006), an external 
subroutine.) 



F-1 



The FORM reference is generated through the $F1 SETC (line 00069), which creates the 
character string $DMFRM to be used at line 00072. In the operand fields of the FORM 
reference, SETA references pick up the counters established by earlier conditional 
instructions. 

In the first call shown, USAGEO sets &UO=1 and REWIND=YES (default) sets &RY=1. 
Since the operand string of the &F1 statement was &CCN,0,0,0,&VO,&VV,&RY,&LB, the 
$DMFRM generates 0,0,0,0,1,0,1,0 as shown in the call expansion. In the second call, 
USAGE=U sets &UV=1, REWIND=YES (default) sets &RY=1, and the $DMFRM generates 
0,0,0,0,0,1,1,0. 



PRINT FUNCTION: 


DATE=72304 


TIME=074604. 


OPENL 


MAC LISTING 


00001 




MACRO 




00002 


&TAG 


OPENL 


8>l DENT=,8.L ABDE F=,&R EWIND' 


00003 




GBLA 


&DMOCCNT 


00004 




ADO 


&DMOCCNT<EQ>0, .DMOPIO 


00005 


&DMOCCNT SETA 


1 


00006 




EXTRN 


&DMOCC 


00007 


&DMFRM 


FORM 


1,1,1,1.1,1,1.1 


00008 


.DMOPIO 


ANOP 




00009 




ADO 


K'&TAG<EQ>0, .DMOP15 


00010 


&TAG1 


SETC 


C'DM' 


00011 


&TG 


SETC 


&SYSNDX 


00012 




AGO 


.DMOP25 


00013 


.DMOP15 


ANOP 




00014 


&TG 


SETC 


C* ' 


00015 




ADO 


K'&TAG < LE >6, .DMOP20 


00016 


&TAG1 


SETC 


STAG 


00017 




AGO 


.DMOP25 


00018 


.DMOP20 


ANOP 




00019 


&TAG1 


SETC 


&TAGI1.6) 


00020 


.DMOP25 


ANOP 




00021 


&LY 


SETA 


&LIST<EQ>C'YES' 


00022 




ADO 


&LY..DMOP30 


00023 




AGO 


.DMOP50 


00024 


.DMOP30 


ANOP 




00025 


&LN 


SETA 


&LIST<EQ>C'NO' 


00026 


&TAG 


LODD 


OPED&SYSNDX,@7 


00027 




ADO 


&LN, .DMOP40 


00028 




BCH 


@$DMOCC 


00029 




AGO 


.MEXIT 


00030 


.DMOP40 


ANOP 




00031 




BSR 


@$DMOCC,6 


00032 




AGO 


.DMOP55 


00033 


.DMOP50 


ANOP 




00034 


&TAG 


ALIGN 


2 


00035 


.DMOP55 


ANOP 





=YES,&USAGE=1,&CONTROL=ANS,8«LIST= 

SET GLOBAL FORM 
AND EXTERNAL 
FIRST TIME 



SET 6 BYTE 

TAG FOR LABEL 

PREFIX ON FIELDS OF 
THE LIST 



LIST=YES 



LIST-NO OR OMITTED 

SET RETURN INTO SAVE AREA 

REG 6 ALREADY POINTS TO PACKET 



SET REG 6 AT PACKET 



Figure F-1 . Macro Definition 
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00036 

00037 

00038 

00039 

00040 

00041 

00042 

00043 

00044 

00045 

00046 

00047 

00048 

00049 

00050 

00051 

00052 

00053 

00054 

00055 

00056 

00057 

00058 

00059 

00060 

00061 

00062 

00063 

00064 

00065 

00066 

00067 

00068 

00069 

00070 

00071 

00072 

00073 

00074 

00075 

00076 

00077 

00078 

00079 

00080 

00081 

00082 

00083 

00084 

00085 

00086 

00087 

00088 



* CHANGE MADE PER PTR 333 06/16/72 DJS 



SETA 

SETA 

SETA 

SETA 

SETA 

SETA 

SETA 

SETA 

SETA 

SETA 

SETA 

SETA 

SETA 

ADO 

MNOTE 

SETA 

ANOP 

ADO 

MNOTE 

SETA 

ANOP 

ADO 

MNOTE 

SETA 

ANOP 

ADO 

MNOTE 

SETA 

ANOP 

ADO 

AGO 

ANOP 

SFTC 

WDD 

BDD 
&TAG1.BT&TG &F1 
&TAG1.ER&TG WDD 

BDD 

BDD 
&TAG1.BD&TG WDD 

BDD 

BDD 

ADO 
**** CHANGE 06/21/72 PIR 4351 
&TAG1.LB&TG WDD &LABDEF 

AGO .MEXIT 

.DMOP80 ANOP 
**** CHANGE 06/21/72 PTR 4351 
&TAG1.LB&TG WDD "0 
.MEXIT ANOP 

OPED&SYSNDX EQU * 

MEND 



&LB 

&UI 

&UO 

&UU 

&USG 

&RY 

&RN 

&REW 

&CCA 

&CCN 

&CNTRL 

&l DNO 

&ERR 



&ERR 
.DMOP60 



&ERR 
.DMOP65 



&ERR 
.DMOP70 



&ERR 
.DMOP73 



.DMOP75 
&F1 



K'&LABDEF<GE>1 

8eUSAGE<EQ>C1* 

8iUSAGE<EQ>C0' 

&USAGE<EQ>C'U' 

&UI+&UO+&UU NE 1 

&REWIND<EQ>C'YES* 

&REWIND<EQ>C'NO' 

8tRY+&RN<NE>1 

&CONTROL< EQ>C'ANS* 

&CONTROL< EQ>C'NATIVE' 

&CCA+8<CCN<NE>1 

K'&IDENT<LT>1 



&IDNO, .DMOP60 

F,***IDENT KEYWORD MISSING*** 

1 



SET COUNTERS 

DEPENDING 

ON 

KEYWORD 

SPECIFICATIONS 



FATAL IF IDENT MISSING 



&USG, .DMOP65 

F,*»*USAGE=>&USAGE INCORRECT SPECIFICATION*** 

1 

&REW, .DMOP70 

F,***REWIND-&REWIND INCORRECT SPECIFICATION*** 

1 

&CNTRL, .DMOP73 

F,»**CONTROL«&CONTROL INCORRECT SPECIFICATION*** 

1 

&ERR, .DMOP75 
.MEXIT 

C'&DMERM' 

"7 LENGTH OF PACKET (WORDS) 

S'04' OPEN 
&CCN,0,0,0,&UO,&UU,&RY,8tLB OPTION BITS 

"0 ERROR RETURNED HERE 

X'00' N/A 

&SYSEG SEGMENT TAG 

&IDENT PIR TO BDT 

XW N/A 

&SYSEG SEGMENT TAG 

&LB, .DMOP80 LABEL PARAMETER 
DJS 



DJS 

CODED 
RETURN HERE 



LBIN0010 LIBRARY FUNCTION COMPLETE 



Figure F-1. Macro Definition (Continued) 
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0224 




OPENL 


IDENT=FILE1 USAGE-0 








0227A 




EXTRN 


&DMOCC 


FIRST TIME 






0228A 


$DMFRM 


FORM 


1,1 1 1 1 1 1 1 




052 E 


B00F0544 


0239A 




LODD 


OPED0002 @7 


SET RETURN INTO SAVE ARE; 


0532 


EA860000 


0242A 




BSR 


@$DMOCC 6 


SET REG 6 AT PACKET 






0245A 


* CHANGE MADE PER PTR 333 06/16/72 DJS 




0536 


0007 


0270A 




WDD 


"7 


LENGTH OF PACKET (WORDS) 


0538 


04 


0271A 




BDD 


X'04' 


OPEN 


0539 


0A 


0272A 


DMBT0002 


&DMFRM 


0,0,0,0,1,0,1,0 


OPTION BITS 


0B3A 


0000 


027 3A 


DMER0002 


WDD 


"0 


ERROR RETURNED HERE 


053C 


00 


0274A 




BDD 


X'OO' 


N/A 


053D 


00 


0275A 




BDD 


SSYSEG 


SEGMENT TAG 


053E 


0082 


0276A 


DMBD0002 


WDD 


FILE1 


PTR to BDT 


0540 


00 


0277A 




BDD 


X'OO' 


N/A 


0541 


00 


0278A 




BDD 


SSYSEG 


SEGMENT TAG 






0281A 


*•** CHANGE 06/21/72 PTR 351 DJS 




0542 


0000 


0282A 


DMLB0002 


WDD 


"0 






0544 


0284A 


OPED0002 


EQU 


# 


RETURN HERE 



Figure F-2. Macro Instruction and Expansion (Call 1) 



05A4 
05A8 

05AC 
05AE 
05AF 
05B0 
05 B2 
05B3 
05B4 
05B6 
05B7 

C5B8 



B00F05BA 
EA860000 

0007 

04 

06 

0000 

00 

00 

0082 

00 

00 

0000 
05BA 



0408 

0420A 

042 3A 

0426A 

0451 A 

0452A 

0453A 

0454A 

0455A 

0456A 

0457A 

0458A 

0459A 

0462A 

0463A 

0465A 



OPENL IDENT=FILE1,USAGE= 

LODD OPED0005.*7 

BSR @$DMOCC,6 

CHANGE MADE PER PTR 333 06/16/72 DJS 



WDD "7 

BDO X'04' 

&DMFRM 0,0,0,0,0,1,1,0 

WDD "0 

BDD X'OO' 

BDD SSYSEG 

WDD FILE1 

BDD X'OO' 

BDD SSYSEG 

**** CHANGE 06/21/72 PTR 351 DJS 

DMLB0005 WDD "0 

OPED0005 EQU * 



DMBT0005 
DMER0005 



DMBD0005 



SET RETURN INTO SAVE AREA 
SET REG 6 AT PACKET 

LENGTH OF PACKET (WORDS) 

OPEN 

OPTION BITS 

ERROR RETURNED HERE 

N/A 

SEGMENT TAG 

PTR TO BDT 

N/A 

SEGMENT TAG 



RETURN HERE 



Figure F-3. Macro Instruction and Expansion (Call 2) 



F-4 



G. ASSEMBLER ERROR MESSAGES 



The Assembler issues two types of errors. They are source error diagnostic messages and 
source error abort messages. Also listed in this section are the system messages that cause 
the Assembler to abort. 



ASSEMBLER SOURCE ERROR DIAGNOSTIC MESSAGES 

The assembler source errors are printed at the end of the listing. 
The messages have the following format: 



LINE 
NUMBER 

nnnn 

where: 

nnnn 



ERROR 
TYPE 



ERROR 
CODE 

aappnnn 



MESSAGE TEXT 



text * insert * text 



aappnnn 



text * insert * text 



is a 4-digit decimal number that refers to the line in the 
source listing where the error occurred. 

is either W designating the error as warning or F desig- 
nating the error as fatal. 

is a 7-character error code where aa is always AS 
specifying the Assembler as the source of the error, 
pp is a 2-digit decimal number indicating the pass of 
the Assembler during which the error occurred, and 
nnn is a 3-digit decimal number specifying the error 
within the pass. 

is the text of the message. If the text contains an insert, 
an asterisk precedes and follows the insert. An insert 
contains the erroneous character and all characters back 
to the beginning of the invalid term. For example, if 
the listing contains an invalid variable symbol, such as 
&8PAM, the insert will contain the characters &8. 



The error messages and their explanations follow. 
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LINE 
NUMBER 

nnnn 



ERROR 
TYPE 



nnnn 



nnnn 



nnnn 



nnnn 



nnnn 



nnnn 



nnnn 



nnnn 



ERROR 
CODE 

AS02001 



nnnn 


F 


AS02002 


nnnn 


F 


AS02003 


nnnn 


F 


AS02004 


nnnn 


F 


AS02005 



AS02006 



AS02007 



AS02008 



AS02009 



AS02010 



AS0201 1 



AS02012 



AS02013 



MESSAGE TEXT 

OPERAND SIZE OR NUMBER OF TERMS 

EXCEEDS MAXIMUM. 

This message indicates internal stack overflow. 

To correct the condition, reduce the number 

of terms in the expression or number of 

operands. 

UNMATCHED RIGHT PARENTHESIS. 

UNMATCHED LEFT PARENTHESIS. 

EXPRESSION OR SUBLIST CONTAINS AN 
INVALID COMMA. 

INVALID SYNTAX *. . .insert. . .* 
An invalid element or combination of 
elements appear. 

INVALID USE OF INDIRECTION. 

*. . .Insert. . .* 

The use of the indirect operator, @, is 

invalid. 

INVALID EXPRESSION *. . .insert. . .* 
The syntax does not follow the rules for 
coding expressions. 

INVALID USE OF LITERALS *. . .insert. . .* 
The use of the literal operator, =, is invalid 
in this statement. 

INVALID USE OF PARENTHESIS 
*. . .insert. . .* 

CHARACTER STRING INVALID WITH 
+ - * OR / OPERATOR *. . .insert. . .* 
Arithmetic operations are invalid with strings. 

INVALID SUBLIST *. . .insert. . .* 
The use of the sublist is invalid in this 
statement. 

RELOCATABLE TERM USED IN MULTI- 
PLICATION, DIVISION OR LOGICAL 
OPERATION *. . .insert. . .* 
The location counter, *, may not enter into 
the above mentioned operations. 

MAY NOT FOLLOW A LOGICAL, RELA- 
TIONAL OR ARITHMETIC OPERATOR 
*. . .insert. . .* 

The unary operator NOT may not follow 
the above mentioned operators. 
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LINE 
NUMBER 



ERROR 
TYPE 



ERROR 
CODE 



MESSAGE TEXT 



NOTE: AS02014 and AS02015 are reserved for future use. 



nnnn 



nnnn 



nnnn 



nnnn 



nnnn 



nnnn 



nnnn 



nnnn 



AS02016 SYMBOL TOO LONG *. . .insert. . .* 

The name entry or a symbolic operand 
may not exceed 8 characters. 

AS02017 INVALID HEXADECIMAL CONSTANT 

*. . .insert. . .* 

A hexadecimal constant may only contain 
digits 0-9 and characters A-F. 

AS02018 OPERAND SIZE OR NUMBER OF TERMS 

EXCEEDS MAXIMUM *. . .insert. . .* 
This message indicates internal stack over- 
flow. To correct the condition, reduce the 
number of terms in the expression or the 
number of operands. 

AS02019 INVALID OPERATOR *. . .insert. . .* 

The operator or symbol is not in the 
language. 

AS02020 INVAL ID CHARACTER *. . .insert. . .* 

The character is not in the language or is 
contextually incorrect. 

AS02021 INVALID CONTINUATION *. . .insert. . .* 

The usage of the semicolon is contextually 
invalid. 

AS02022 INVALID SYMBOL *. . .insert. . .* 

The length attribute operand may only be 
symbolic. 

AS02023 INVALID STRING *. . .insert. . .* 

An invalid string structure appeared. 



NOTE: AS02024 is reserved for future use. 



nnnn 



nnnn 



W 



nnnn 



W 



AS02025 INVALID STRING *. . .insert. . .* 

Same as AS02023 above. 

AS02026 OPERAND TRUNCATED - TOO LONG 

*. . .insert. . .* 

The number of digits exceeds the maximum 
allowed. For a decimal integer, 5 is the maxi- 
mum. For an integer string, 10 is the maxi- 
mum. For a hexadecimal constant, 4 is the 
maximum. 

AS02027 VALUE TRUNCATED - EXCEEDS PER- 

MISSIBLE MAGNITUDE *. . .insert. . .* 
A decimal integer may not exceed 65,535. 
An integer string may not exceed 268,435,455. 
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LINE 
NUMBER 

nnnn 



nnnn 
nnnn 

nnnn 
nnnn 

nnnn 
nnnn 

nnnn 
nnnn 



ERROR 
TYPE 



nnnn 



nnnn 



nnnn 

nnnn 
nnnn 



W 
F 



W 
F 



W 



W 



F 
F 



ERROR 
CODE 

AS02028 



AS02029 
AS02030 

AS02031 
AS02032 

AS02033 
AS02034 

AS02035 
AS02036 



AS02037 



AS02038 



AS02039 

AS02040 
AS02041 



MESSAGE TEXT 

OPERAND ENTRY MISSING. 
The operation code in this statement 
requires an operand field entry. 

CONTINUATION LINE IS BLANK. 

TOO MANY CONTINUATION STATEMENTS. 
In a normal statement, only one continued 
statement is allowed. 

VARIABLE SYMBOL MUST START WITH & 
FOLLOWED BY A-Z OR $. 

LEFT PARENTHESIS MAY NOT BE 
IMMEDIATELY PRECEDED BY A 
VARIABLE SYMBOL. 

VARIABLE SYMBOL MUST START WITH & 
FOLLOWED BY A-Z OR $. 

VARIABLE SYMBOL TOO LONG. 

The variable symbol is greater than 7 characters 

excluding the ampersand sign. 

.* COMMENT VALID ONLY WITH A MACRO. 

CHARACTER THAT FOLLOWS . OR & MUST 
BE A-Z OR $. 

Period or & is followed by a numeric or an 
illegal character in the name field. 

NAME ENTRY TOO LONG. 
In an ordinary symbol, only 8 characters are 
allowed and in a sequence or variable symbol 
only 7 characters are allowed. 

INVALID CHARACTER IN NAME ENTRY. 
Only characters allowed are A-Z, 0-9 and $. 
For a sequence or variable symbol, the first 
character must be . or & respectively. 

OPERATION ENTRY MISSING. 
An operation entry is required in every state- 
ment. 

NAME ENTRY CANNOT BE CONTINUED. 

NAME ENTRY MUST BE FOLLOWED BY A 

SPACE. 

The space is the delimiter of each field in the 

MRX Assembler. 



G-4 



LINE ERROR ERROR 

NUMBER TYPE CODE 

nnnn F AS02042 



nnnn 


F 


AS02043 


nnnn 


F 


AS02044 


nnnn 


F 


AS02045 



nnnn 



W 



nnnn 



nnnn 



W 



W 



nnnn 



W 



nnnn 



AS02046 



AS02047 



AS02048 



AS02049 



AS02051 



MESSAGE TEXT 

OPERATION ENTRY MUST BE FOLLOWED 
BY A SPACE. 

The space is the delimiter of each field in the 
MRX Assembler. 

OPERATION CODE CANNOT BE CONTINUED. 

INVALID CHARACTER IN OPERATION 

ENTRY. 

Only valid characters are A-Z, 0-9, & and $. 

OPERATION ENTRY TOO LONG. 
Only 8 characters are allowed if there is no 
substitution in the operation entry. 

INVALID ISEQ PARAMETERS - COMMAND 
IGNORED. 

1 . The parameter value is within the begin 
and end limits in the statement. 

2. The length of the sequence field is zero. 

3. The length of the sequence field is greater 
than 8 characters. 

MISPLACED ICTL STATEMENT. 

An ICTL statement must be the first statement 

of an assembly. 

STATEMENT VAL ID ONLY WITHIN A 

MACRO. 

The following operation codes are allowed 

within a macro definition: 

GBLA 

GBLC 

MACRO 

MEND 

MNOTE 

MEXIT 

INVALID OR MISPLACED INSTRUCTION IN 
MACRO DEFINITION. 
The following operation codes are not allowed 
within a macro definition: 

PRINT 

ISEQ 

MACRO 
Also GBLA, GBLC must immediately follow the 
macro definition prototype. 

INVALID CONTINUATION. 

The continued statement has a continuation 

character as the first nonblank character. 
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Bulletin: 2202.001-0101 
Date: 3/19/73 



LINE 

NUMBER 
nnnn 



nnnn 



nnnn 



nnnn 



ERROR 
TYPE 

W 



W 



w 



ERROR 
CODE 

AS02052 



AS02053 



AS02054 



AS02055 



nnnn 


F 


AS02056 


nnnn . 


F 


AS02057 


nnnn 


F 


AS02058 


nnnn 


F 


AS02059 


nnnn 


W 


AS02060 


nnnn 


W 


AS02061 


nnnn 


F 


AS02062 


nnnn 


W 


AS02063 


nnnn 


W 


AS02064 


nnnn 


W 


AS02065 



nnnn 



W 



AS02066 



MESSAGE TEXT 

END STATEMENT SUPPLIED BY ASSEMBLER. 
End of input detected but no end card received. 

NAME FIELD OF MEND STATEMENT MAY 
ONLY CONTAIN A SEQUENCE SYMBOL. 

NAME FIELD OF MACRO DEFINITION 
HEADER MUST BE BLANK. 
The name of the operation code MACRO 
must be blank. 

REQUIRED OPERAND ENTRY MISSING. 
The operation code in the statement requires 
an operand field entry. 

SYMBOLIC PARAMETER CANNOT BE 
USED AS A GBLA OR GBLC OPERAND. 

SET SYMBOL MAY NOT BE DEFINED AS 
BOTH SETA AND SETC. 

INVALID SYNTAX MATCHING QUOTE MISSING. 

MACHINE AND ASSEMBLER OPERATION 
CODES MAY NOT BE USED AS MACRO 
INSTRUCTION. 

MULTIPLE DEFINITION OF MACRO 

INSTRUCTION. 

Macro instruction has been previously defined. 

NAME ENTRY OF MACRO PROTOTYPE 
STATEMENT MUST BE BLANK OR A 
VARIABLE SYMBOL. 

MORE THAN 35 SYMBOLIC PARAMETERS. 
Only 35 symbolic parameters are allowed. 

NAME ENTRY OF MACRO INSTRUCTION 
MAY NOT BE A VARIABLE SYMBOL. 

STATEMENT OUT OF SEQUENCE. 

INVALID ISEQ SYNTAX. 
In an ISEQ statement the name entry must be 
blank and the parameters must be separated by 
a comma and must be terminated by a space. 

INVALID ICTL SYNTAX. 

In an ICTL statement the name entry must be 

blank. 
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LINE 


ERROR 


ERROR 


NUMBER 


TYPE 


CODE 


nnnn 


W 


AS02067 


nnnn 


F 


AS02068 



nnnn 



nnnn 



AS02069 



AS02070 



MESSAGE TEXT 

NAME FIELD OF GBLA AND GBLC 
STATEMENTS MUST BE BLANK. 

OPERAND SYNTAX ERROR. 
An invalid character is in the operand field 
or invalid termination of a sublist, etc., 
appears in the operand field. 

OPERAND LENGTH ERROR. 

The maximum number of characters allowed 

per operand is 127. 

MORE THAN 35 OPERANDS. 
Only 35 operands are allowed in a macro 
prototype or a GBLA or GBLC statement or 
a macro definition instruction statement. 



nnnn 



W 



AS02071 NAME ENTRY MAY NOT BE A SEQUENCE 

SYMBOL. 



nnnn 



W 



AS02072 NAME FIELD MUST CONTAIN A SET 

SYMBOL. 



nnnn 



W 



AS02073 SET SYMBOL MAY NOT BE DEFINED AS 

BOTH SETA AND SETC. 



nnnn 



Wor F 



nnnn 



W 



AS02074 MNOTE *. . .insert. . .* 

An MNOTE Assembler instruction has been 
encountered. The MNOTE message is output 
to the error file and processing continues. 

AS02075 VALUE OF OPERAND EXCEEDS 65535. 

A number being converted from EBCDIC to 
binary has a value greater than +65535. The 5 
least-significant digits are converted to binary 
and only the least -significant 16 bits of the 
result are retained. 



nnnn 



nnnn 



AS02076 INVALID ADO EXPRESSION. 

The expression in the operand field of this 
ADO instruction did not resolve to an 
integer of value between and 65535. The 
ADO statement is not processed. 

AS02077 IMPROPER ADO TERMINATION. 

1 . The sequence symbol in the name field 
of this ADO statement terminates the 
currently active ADO loop. The currently 
active ADO loop is unstacked and the 
ADO statement is not processed. 
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LINE 
NUMBER 



ERROR 
TYPE 



ERROR 
CODE 



nnnn 



nnnn 



AS02078 



AS02079 



nnnn 



AS02080 



nnnn 



AS02081 



nnnn 



AS02082 



MESSAGE TEXT 

2. The sequence symbol in the name field 
of this macro instruction terminates the 
currently active ADO loop. The 
currently active ADO loop is unstacked. 

3. A MEXIT or MEND instruction has been 
encountered, and the currently active 
ADO loop is at the current macro nesting 
level. The currently active ADO loop is 
unstacked. 

SECOND ADO OPERAND MISSING. 
The sequence symbol is missing from the 
operand field of this ADO statement. The 
ADO statement is not processed. 

BACKWARD BRANCH IN ADO OR AGO. 
The statement which contains the sequence 
symbol referred to in this ADO or AGO 
statement precedes the current statement. 
The ADO or AGO statement is not 
processed. 

INVALID CONTINUATION. 

1 . Substitution into a source statement 
cannot be completed without generating 
more than one continuation line. Sub- 
stitution is discontinued. 

2. Substitution into a form reference 
cannot be completed without generating 
more than one continuation line. The 
statement is not processed. 

DUPLICATE DEFINITION OF VARIABLE 
SYMBOL. 

1 . A variable symbol defined in a macro 
instruction is already in the local symbol 
table at the current macro nesting level. 

2. &SYSECT or &SYSNDX is already in the 
local symbol table at the current macro 
nesting level. 

The value already in the symbol table is 
retained. 

DUPLICATE FORM DEFINITION. 
More than one definition was encountered 
for the current form. The form definition 
is dropped. 
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LINE 
NUMBER 

nnnn 



ERROR 
TYPE 



ERROR 
CODE 

AS02083 



nnnn 



AS02084 



nnnn 



AS02085 



nnnn 



AS02086 



nnnn 



AS02087 



nnnn 



AS02088 



MESSAGE TEXT 

INVALID SEQUENCE SYMBOL. 

1 . Sequence symbol does not start with a 
period followediby a letter or $. 

2. Sequence symbol is not 1 -8 characters 
followed by a space. 

The instruction is replaced with ERR. 

INVALID FORM SYNTAX. 
The form reference contains a keyword 
parameter or a sublist parameter. The form 
reference is dropped. 

UNDEFINED SET SYMBOL OR SYMBOLIC 
PARAMETER. 

1 . Set symbol or symbolic parameter is 
not found in symbol table. Substitute 
null value for missing value. 

2. Global set symbol is not found in 
symbol table. The ADO statement is 
not processed. 

3. Global set symbol is not found in 
symbol table. The SETA or SETC 
statement is not processed. 

INVALID SUBSTITUTION OF SEMICOLON. 
The first character of the value assigned to a 
variable symbol is a semicolon, and the 
character which would immediately precede it 
in the substitution record is not an escape 
character ( ). Substitute null for the value. 

UNDEFINED MACRO. 

1 . The operation code in a statement 
created by substitution is neither an 
ordinary instruction nor a form 
instruction. 

2. The operation code in this statement 
is neither an ordinary instruction nor 

a form instruction, nor can it be found 
in the macro library. 
The instruction is replaced by ERR. 

INVALID NAME ENTRY. 

1 . Symbol in the name field of record 
created by substitution is either too 
long or contains an invalid character. 

2. Name field of form definition is either 
an instruction mnemonic or it is not an 
ordinary symbol. 
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LINE ERROR 

NUMBER TYPE 



ERROR 
CODE 



nnnn 



nnnn 



nnnn 



nnnn 



nnnn 



AS02089 



AS02090 



AS02091 



AS02092 



AS02093 



nnnn 



nnnn 



AS02094 
AS02095 



MESSAGE TEXT 

3. Statement has nonblank name field. 

4. Statement has nonblank name field 
which is not a sequence symbol. 

5. Statement has nonblank name field 
which is not an ordinary symbol or 
a sequence symbol. 

6. Name field of ADO statement contains 
an ordinary symbol. 

7. Name field of SETA statement does not 
contain a SETA symbol. 

8. Name field of a SETC statement does 
not contain a SETC symbol. 

For conditions 1, 3, 4, 5, and 6, the name 
field is ignored. For condition 2, form 
definition is not processed. For conditions 
7 and 8, SETA and SETC statements are 
not processed. 

ADO OR AGO OPERAND MUST BE A 

SEQUENCE SYMBOL. 

The ADO or AGO statement is not processed. 

&SYSNDX NOT IN SYMBOL TABLE. 
Assembler logic error. The SETA and SETC 
statement is not processed. 

MORE THAN FIVE LEVELS OF MACRO 

NESTING. 

The instruction is replaced by ERR. 

OPERAND LENGTH ERROR. 

Length of operand or suboperand exceeds 

127 bytes. The operand is replaced by null. 

TOO MANY OPERANDS. 

1 . More operands are in a macro call than 
there are parameters in the prototype. 

2. AGO, SETA, or SETC statement 
contains more than one operand. 

3. ADO statement contains more than 
two operands. 

The extra operands are ignored. 

MACRO DEFINITION ERROR. 
Macro instruction is replaced by ERR. 

TOO MANY LEVELS OF ADO NESTING. 
The ADO statement is not processed. 
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LINE 
NUMBER 

nnnn 



ERROR 
TYPE 



ERROR 
CODE 

AS02096 



nnnn 



W 



AS02097 



nnnn 



nnnn 



AS02098 



AS02099 



nnnn 



AS02100 



nnnn 



nnnn 



AS02101 
AS02102 



MESSAGE TEXT 

INNER ADO LOOP MUST BE COMPLETELY 

CONTAINED WITHIN THE OUTER ADO 

LOOP. 

Processing of the outer ADO loop is discontinued. 

INVALID PRINT OPERAND. 

1 . The operand field is terminated by a comma 
or semicolon. 

2. One of the operands is not "OFF, ON, 
NOGEN, GEN, NODATA, DATA, 
NOCOND, ORCOND." 

The remainder of the operand is ignored and the 
assembly process continues, using the last valid 
operand processed for each option. 

MACRO INSTRUCTION MAY NOT HAVE 

BOTH POSITIONAL AND KEYWORD 

PARAMETERS. 

The macro instruction is not processed. 

MACRO INSTRUCTION USED AS FORM 

NAME. 

The name field of a form definition which 

was created by substitution contains a 

mnemonic that has been identified as a 

macro instruction. The form definition 

is not processed. 

INVALID SET EXPRESSION. 

1 . The operand field of SETA instruction 
contains a nonnumeric character. 

2. The value of a SETA expression exceeds 
65,535. 

3. The operand field of a SETA or SETC 
instruction contains a sublist or a 
sequence symbol. 

The SETA or SETC instruction is not processed. 

REFERENCE TO UNDEFINED SET SYMBOL. 
This is an Assembler logic error. 

INVALID SUBSTITUTION. 

1 . The symbol whose value is to be used in 
substitution is not a SETA, a SETC, a 
symbolic parameter, or &SYSNDX. This 
is an Assembler logic error. The value is 
replaced by null. 

2. The name field of a statement created by 
substitution contains a sequence symbol. 
The name field of the statement is ignored. 



G-11 



LINE 
NUMBER 

nnnn 



nnnn 



ERROR 
TYPE 



ERROR 
CODE 

AS02103 



AS02104 



nnnn 



W 



AS02105 



nnnn 



nnnn 



AS02106 



AS02107 



nnnn 



nnnn 



AS02108 



AS02109 



nnnn 



AS02110 



MESSAGE TEXT 

REFERENCE TO &SYSNDX VALID ONLY 

WITHIN A MACRO. 

The SETA or SETC statement is not processed. 

REFERENCE TO UNDEFINED FORM. 
Reference to a form instruction whose definition 
has not yet appeared in the generated source. 
The instruction is replaced by ERR. 

UNDEFINED KEYWORD OPERAND. 

1. The macro instruction has more operands 
than the macro prototype has parameters. 

2. The macro instruction has at least one 
operand whose name does not match any 
of the prototype's keyword parameters. 

The extra operands are ignored. 

REFERENCE TO UNDEFINED SEQUENCE 

SYMBOL. 

The ADO or AGO statement is not processed. 

INVALIDSUBSTITUTION INTO OPERATION 

ENTRY. 

The instruction in this substitution record was 

one which may not be created by substitution. 

The instruction is not processed. 

MORE THAN 35 SUB-OPERANDS. 
This is an Assembler logic error. 

OPERATION ENTRY MISSING. 

1 . The statement created by substitution is 
all blank after the name field. 

2. The statement created by substitution 
has a continuation character immedi- 
ately after the name field. 

The instruction is replaced by ERR. 

INVALID OPERATION ENTRY. 

1 . The operation code in the statement 
created by substitution is more than 
eight characters long. 

2. The operation field in the statement 
created by substitution contains an 
invalid character. 

3. The operation code in the statement 
created by substitution is continued 
on the second line of the statement. 

The instruction is replaced by ERR. 
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F 


AS02112 


nnnn 


W 


AS02114 



NOTE : AS021 1 5 reserved for future use. 

nnnn F AS02116 

NOTE : AS021 1 7 reserved for future use. 

nnnn F AS02118 



MESSAGE TEXT 

REFERENCE TO DOUBLY-DEFINED 

SEQUENCE SYMBOL. 

The ADO or AGO statement is not processed. 

INSTRUCTION NOT VALID AFTER SEG 

STATEMENT. 

The instruction is not processed. 

SPECIFIED SUBSTRING - LENGTH TOO 
LARGE. 



INVALID USE OF SEQUENCE SYMBOL. 



INVALID USE OF CHARACTER STRING. 



NOTE 
NOTE 
NOTE 
nnnn 

nnnn 
nnnn 
nnnn 

nnnn 

nnnn 



AS021 19 reserved for future use. 
AS02120 reserved for future use. 
AS02121 and AS02122 reserved for future use. 



F 
F 
F 

F 

F 



AS02123 

AS02124 
AS02125 
AS02126 

AS02127 

AS03001 



nnnn 


F 


AS03002 


nnnn 


F 


AS03003 


nnnn 


F 


AS03004 



EXPRESSION CONTAINS INCOMPATIBLE 
OPERAND TYPES. 

EVALUATOR - STACK OVERFLOW. 

MULTIPLICATION OR DIVISION OVERFLOW. 

UNDEFINED SEQUENCE SYMBOL OR 
VARIABLE SYMBOL. 

INVALID SUBSTRING OR SUBLIST 
REFERENCE. 

OPERAND SIZE OR NUMBER OF TERMS 
EXCEEDS MAXIMUM. 
This message indicates internal stack overflow. 
To correct the condition, reduce the number 
of terms in the expression or number of oper- 
ands. 

UNMATCHED RIGHT PARENTHESIS. 

UNMATCHED LEFT PARENTHESIS. 

EXPRESSION OR SUBLIST CONTAINS AN 
INVALID COMMA. 
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AS03005 



MESSAGE TEXT 



INVALID SYNTAX '...insert...* 

The lexical or contextual syntax is invalid. 



nnnn 



nnnn 



nnnn 



nnnn 



nnnn 



nnnn 



nnnn 



nnnn 



AS03006 INVALID USE OF INDIRECTION 

*. . .insert. . .* 
The use of the indirect operator, @, is invalid. 

AS03007 INVALID EXPRESSION *. . .insert. . .* 

The syntax does not follow the rules for 
coding expressions. 

AS03008 INVAL ID USE OF LITERALS *. . .insert. . .* 

The use of the literal operator, =, is invalid in 
this statement. 

AS03009 INVAL ID USE OF PARENTHESIS 

*. . .insert. . .* 

AS03010 CHARACTER STRING INVALID WITH 

+ - * OR / OPERATOR *. . .insert. . .* 
Arithmetic operations are invalid with strings. 

AS03011 INVALID SUBLIST *. . .insert. . .* 

The use of the sublist is invalid in this 
statement. 

AS03012 RELOCATABLE TERM USED IN MULTI- 

PLICATION, DIVISION OR LOGICAL 
OPERATION ». . .insert. . .* 
The location counter, *, may not enter into 
the above mentioned operations. 

AS03013 MAY NOT FOLLOW A LOGICAL, RELA- 

TIONAL OR ARITHMETIC OPERATOR 
*. . .insert. . .* 

The unary operator NOT may not follow the 
above mentioned operators. 



NOTE: 
nnnn 

nnnn 



AS03014 and AS03015 are reserved for future use. 



AS03016 SYMBOL TOO LONG *. . .insert. . .* 

A name entry or a symbolic operand may not 
exceed 8 characters. 

AS03017 INVALID HEXADECIMAL CONSTANT 

*. . .insert. . .* 

A hexadecimal constant may only contain 
digits 0-9 and characters A-F. 
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AS03019 



AS03020 



AS03021 



AS03022 



AS03023 



Bulletin: 2202.001-0101 
Date: 3/19/73 



MESSAGE TEXT 

OPERAND SIZE OR NUMBER OF TERMS 
EXCEEDS MAXIMUM *. . .insert. . .* 
This message indicates internal stack overflow. 
To correct the condition, reduce the number 
of terms in the expression or the number of 
operands. 

INVAL ID OPERATOR *. . .insert. . .* 

The operator or symbol is not in the language. 

INVALID CHARACTER *. . .insert. . .* 
The character is not in the language or is 
contextually incorrect. 

INVALID CONTINUATION *. . .insert. . .* 
The usage of the semicolon is contextually 
invalid. 

INVAL ID SYMBOL *. . .insert. . .* 
The length attribute operand may only be 
symbolic. 

INVALID STRING *. . .insert. . .* 
An invalid string structure appeared. 



nnnn 



nnnn 



W 



nnnn 



nnnn 



W 



nnnn 



W 



AS03024 INVALID STRING *...insert...* 

Same as AS03023 above. 

AS03025 FLOATING-POINT CONSTANT* insert * 

OVER/UNDERFLOW 
The explicitly coded exponent or the value 
exceeds permissible magnitude. An 8-byte 
floating point zero is generated. 

AS03025 INVALID STRING *. . .insert. . .* 

Same as AS03023 above. 

AS03026 OPERAND TRUNCATED - TOO LONG 

*. . .insert. . .* 

The number of digits exceeds the maximum 
allowed. For a decimal integer, 5 is the 
maximum. For an integer string, 10 is the 
maximum. For a hexadecimal constant, 4 
is the maximum. 

AS03027 VALUE TRUNCATED - EXCEEDS PER- 

MISSIBLE MAGNITUDE *. . .insert. . .* 
A decimal integer may not exceed 65,535. 
An integer string may not exceed 4,294,967,295. 



NOTE: AS03028 and AS03029 are reserved for future use. 



nnnn 



W 



AS03030 



INVALID USE OF NAME ENTRY. 
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AS03032 


nnnn 


F 


AS03033 



nnnn 



nnnn 



nnnn 



nnnn 



AS03034 



AS03035 



AS03036 



AS03037 



MESSAGE TEXT 

INVALID FORM DEFINITION. 

A form reference cannot be used as an operand 

entry. 

INVALID USE OF $SYSEG. 

$SYSEG is invalid in an evaluated expression. 

RELOCATABLE TERM INVALID WITH 
UNARY OPERATOR. 
A relocatable term may not be used in con- 
junction with a NOT operator. 

INVALID USE OF STRING CONSTANT. 
A string constant may not be used as a term 
in conjunction with an arithmetic or logical 
operator. 

RELOCATABLE TERM INVALID WITH */ 
OR LOGICAL OPERATOR *. . .insert. . .* 
A relocatable term may not be used in con- 
junction with a multiplication, division, or 
logical operation. 

INVALID SYNTAX. 

The operand structure does not follow the 

rules of the language. 

MORE THAN SIX RELOCATABLE TERMS. 
An expression may not contain more than six 
unresolved relocatable terms. 



NOTE : AS03038 is reserved for future use. 
nnnn F AS03039 



nnnn 



nnnn 



AS03040 



AS03041 



INVALID STRING ». . .insert. . .* 

Both strings in a relational or logical operation 

must be the same type. 

OPERAND SIZE OR NUMBER OF TERMS 

EXCEEDS MAXIMUM *.. .insert. . .* 

The expression size is too large to be evaluated. 

MULTIPLICATION OR DIVISION OVER- 
FLOW *. . . insert . . .* 
Either division overflow has occurred or the 
second term of a multiplication or division 
operation exceeds a 1 6-bit value. 



N OTE : AS03042 is reserved for f utu re use. 
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AS03044 



MESSAGE TEXT 

RELOCATABLE TERM INVAL ID WITH 
RELATIONAL OPERATOR *. . .insert. . .* 
A relocatable term may not be used in con- 
junction with a relational operator. 

UNDEFINED SYMBOLIC OPERAND. 
The reference is not used as a label within 
this program. 



NOTE: AS03045 is reserved for future use. 

NOTE : AS03046 through AS03050 are reserved for future use. 



nnnn 



nnnn 



nnnn 



nnnn 



AS03051 DUPLICATE ENTRY OF A SYMBOLIC 

DEFINITION *. . .insert. . .* 
The name field entry definitions must be 
unique. All duplicates are discarded. 

AS03052 ENTRY POINT DEFINITION IS NOT 

RELOCATABLE *.. .insert. . .* 
The entry point definition must resolve 
to a relocatable term. 

AS03053 CSECT NAME IS ALREADY DEFINED, 

BUT NOT AS CSECT *. . .insert. . .* 
Control section names must not appear as 
ordinary name field entries. 

AS03054 COM NAME IS ALREADY DEFINED, 

BUT NOT COM *. . .insert. ..« 
COM names must not appear as ordinary 
name field entries. 



NOTE: AS03055 is the same as AS03052. 

NOTE : AS03056 through AS03058 are reserved for future use. 



nnnn 



nnnn 



nnnn 



AS03059 DUPLICATE FORM DEFINITION. .. . .insert. . .. 

The form definition name entry is previously 
defined. 

AS03060 INVALID SYNTAX IN STORAGE 

RESERVATION. 

The operand of a reserve storage instruction 
must be preresolved, absolute, positive arithmo 
tic expression. Only one operand is allowed. 

AS03061 INVALID SYNTAX IN DATA DEFINITION. 

The syntactical structure of the data definition 
operand is invalid. 
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nnnn 



nnnn 



W 



AS03066 
AS03067 



MESSAGE TEXT 

INVALID USE OF INDIRECTION. 
An indirect operator is invalid in data 
definition operands. 

INVALID USE OF LITERAL. 

The literal operator is invalid in size or 

repetition field of a data definition operand. 

INVALID SIZE SPECIFICATION. 

The size operand of data definitions must 

be preresolved absolute expression. 

INVALID REPETITION FACTOR. 
The repetition factor of a data definition 
operand must be a preresolved absolute 
expression. 

VALUE OF LOCATION COUNTER 
EXCEEDS 65,535. 

TRUNCATION OCCURRED. 
The implied size of the value operand is 
greater than the explicit size operand in a 
data definition. 



NOTE: AS03068 through AS03069 are reserved for future use. 



nnnn 



nnnn 



nnnn 



nnnn 



nnnn 



AS03070 INVALID USE OF $SYSEG. 

The data following $SYSEG definition must 
be two bytes long, word aligned, and relocatable. 

AS03071 REQUIRED OPERAND ENTRY MISSING. 

This instruction requires an operand and none 
was supplied. 

AS03072 INVALID SUBLIST. 

The syntax indicates a suboperand, but the 
instruction does not allow suboperands. 

AS03073 INVALID USE OF LITERAL. 

The instruction does not allow a literal as an 
operand, but one was coded. 

AS03074 INVALID USE OF INDIRECTION. 

The instruction does not allow indirection, 
but indirection was coded. 
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nnnn 
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W 



AS03076 
AS03077 



nnnn 



nnnn 



W 



nnnn 



nnnn 



F 
F 



AS03078 
AS03079 

AS03080 
AS03081 



nnnn 



W 



AS03082 



nnnn 



AS03083 



MESSAGE TEXT 

INVALID EXPRESSION. 

The expression coded does not fall within the 

types allowed. 

1 . A string type was used where only 
arithmetic type expressions are allowed. 

2. An unresolved expression was coded on 
an instruction which required expressions 
to be predefined. 

3. A relocatable expression is coded where 
only absolute are allowed. 

NAME FIELD OF ORG STATEMENT MAY 
ONLY CONTAIN A SEQUENCE SYMBOL. 

INVALID RELOCATION. 

1 . An absolute value was coded where a 
relocatable value was required. 

2. The relocation identifier does not 
match the relocation identifier for the 
control section in effect; e.g., trying to 
ORG to another CSECT or COM section. 

NAME ENTRY REQUIRED ON AN EQU 
STATEMENT. 

TOO MANY OPERANDS. 
More than the maximum number of operands 
allowable for this instruction were coded. The 
values of the first operands were used. 

ONLY SINGLE TERM RELOCATABLE 
EXPRESSIONS ARE VALID. 

COMBINED CSECT, COM AND EXTRN 
COUNT EXCEEDS 252. 
The binary generated will probably not be 
useless. Reduce the number of EXTERNs 
and CSECTs and COMs and reassemble. 

INVALID NAME ENTRY. 
The name entry was coded where none was 
allowed. The name entry has not been entered 
into the symbol table. Any reference to it will 
result in an undefined reference. 

REFERENCE TO INVALID FORM DEFINITION. 

1 . The operation entry matches something other 
than a FORM definition. 

2. There was no such entry. 

3. No operand was coded on the reference. 
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nnnn 



MESSAGE TEXT 

OPERAND SIZE EXCEEDS 255 BITS. 
A FORM definition was coded with an operand 
which did not resolve to an absolute value less 
than 255. 



AS03085 DUPLICATE ENTRY OF A SYMBOLIC 

DEFINITION. 



nnnn 



nnnn 



nnnn 



nnnn 



W 



nnnn 



nnnn 



nnnn 



nnnn 



nnnn 



nnnn 



AS03086 NAME ENTRY REQUIRED ON A FORM 

DEFINITION. 

AS03087 CSECT OR COM NAMES MAY NOT 

DUPLICATE ANOTHER NAME. 
The name entries of CSECT and COM state- 
ments cannot duplicate each other or other 
symbols in the same assembly. 

AS03088 ONLY ONE TITLE STATEMENT IN A 

PROGRAM MAY HAVE A NONBLANK 
NAME FIELD. 

AS03089 INVALID PRIME ENTRY POINT. 

1 . The operand of an END statement does 
not resolve to an even boundary. 

2. The operand does not reference a 
relocatable value. 



AS04001 

AS04002 
AS04003 

AS04004 

AS04005 



AS04006 



INVALID FORM DEFINITION. 

A form reference cannot be used as an operand 

entry. 

INVALID USE OF $SYSEG. 

$SYSEG is invalid in an evaluated expression. 

RELOCATABLE TERM INVALID WITH 
UNARY OPERATOR. 
A relocatable term may not be used in 
conjunction with a NOT operator. 

INVALID USE OF STRING CONSTANT. 
A string constant may not be used as a term 
in conjunction with an arithmetic or logical 
operator. 

RELOCATABLE TERM INVALID WITH */ 
OR LOGICAL OPERATOR •...insert...* 
A relocatable term may not be used in conjunc- 
tion with a multiplication, division, or logical 
operation. 

INVALID SYNTAX. 

The operand structure does not follow the rules 

of the language. 
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NOTE : AS04008 is reserved for future use. 
nnnn F AS04009 



nnnn 



nnnn 



AS04010 



AS04011 



NOTE : AS0401 2 is reserved for future use. 
nnnn F AS04013 



nnnn 



AS04014 



NOTE : AS0401 5 reserved for future use. 
nnnn W AS04016 



nnnn 
nnnn 

nnnn 



W 
W 



AS04017 
AS04018 

AS04019 



MESSAGE TEXT 

MORE THAN SIX RELOCATABLE TERMS. 
An expression may not contain more than six 
unresolved relocatable terms. 



INVALID STRING •...insert...* 

Both strings in a relational or logical operation 

must be the same type. 

OPERAND SIZE OR NUMBER OF TERMS 

EXCEEDS MAXIMUM *. . .insert. . .* 

The expression size is too large to be evaluated. 

MULTIPLICATION OR DIVISION OVERFLOW 
*. . .insert. . .* 

Either division overflow has occurred or the 
second term of a multiplication or division 
operation exceeds a 16-bit value. 



RELOCATABLE TERM INVALID WITH 
RELATIONAL OPERATOR *. . .insert. . .* 
A relocatable term may not be used in conjunction 
with a relational operator. 

UNDEFINED SYMBOLIC OPERAND. 

The reference is not used as a label within this 

program. 



TRUNCATION OCCURRED. 
The value coded exceeded the match field on a 
FORM definition. Normal rules of truncation 
are followed. 

TOO MANY OPERANDS. 

REQUIRED OPERAND ENTRY MISSING. 
Fewer operands were coded in a form reference 
than were coded in the FORM definition. 

INVALID RELOCATION-VALUE TREATED 
AS ABSOLUTE. 

1 . The receive field was not 1 6 bits or was 
not on an even byte boundary. The number 
of relocation identifiers was greater than one. 

2. For $SYSEG, the receive field was not 8 bits 
long, or was not on a byte boundary. 
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NOTE: AS04021 is reserved for future use. 
W AS04022 



nnnn 



nnnn 



W 



nnnn 



W 



AS04023 



AS04024 



NOTE: AS04025 is reserved for future use. 
nnnn W AS04026 



nnnn 



nnnn 



W 



AS04027 



AS04028 



NOTE : AS04029 is reserved for future use. 
nnnn W AS04030 



nnnn 



nnnn 



AS04031 



AS04032 



MESSAGE TEXT 

INVALID SYNTAX. 

The syntax of a FORM reference operand may 

have had one of the following errors: 

1. Indirection coded 

2. A sublist coded 

3. No operand was coded. 



TITLE OPERAND MUST BE A CHARACTER 
STRING. 

LENGTH OF TITLE OPERAND EXCEEDS 90 

CHARACTERS. 

The operand is truncated on the right to 90 

bytes and then used. 

SPACE OPERAND MUST BE A RESOLVED 
ARITHMETIC EXPRESSION. 



FORWARD REFERENCE TO STRING EQUATE 
- IMPLICIT STRING - LENGTH IS 2 BYTES. 
A data definition operand referencing a forward 
string equate is implicitly resolved to two bytes. 
Truncation or padding may have occurred. 

TRUNCATION OCCURRED. 

The implicit size of the value operand is greater 

than the explicit size operand in data definitions. 

INVALID RELOCATION - VALUE TREATED 
AS ABSOLUTE. 

A relocatable value must be on word boundary 
and two bytes in length. The number of relocation 
factors in an expression must be resolved to one. 



NOP SUBSTITUTED FOR INVALID 
OPERATION CODE. 

TOO MANY OPERANDS OR SUBOPERANDS. 
Refer to the MRX/OS Assembler Reference 
manual to determine the maximum number of 
operands. 

INVALID INDIRECTION OR LITERAL USAGE. 
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nnnn 
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nnnn 



nnnn 



nnnn 



W 



W 
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nnnn 



nnnn 



nnnn 



nnnn 



W 



W 



w 



w 



AS04041 

AS04042 
AS04043 
AS04044 



MESSAGE TEXT 

LITERAL POOL SIZE EXCEEDS MEMORY 

LIMITS. 

The current literal pool is located at an address 

greater than 65,535. Binary generation is 

suppressed. 

INVALID USE OF STRING CONSTANT. 
A string constant may have been used as an 
address or as a register designator. 

LOSS OF SIGNIFICANCE. 

An immediate operand cannot contain the 

amount coded. 

INVALID RELOCATION. 

More than one relocatable value remains after 

evaluation. 

REQUIRED SUBOPERAND MISSING. 
An instruction which must have a certain 
minimum of operands or suboperands has 
been coded without one or more of them. 

VALUE NOT WITHIN RANGE OF 
DESIGNATED FIELD. 
The resolved value exceeds the maximum 
value permitted. 

EXPLICIT USE OF REGISTER ZERO AS 
AN INDEX. 

Register zero has no effect as an index register, 
but it was coded as an index. 

TRUNCATION OCCURRED. 
A string constant used in a direct instruction 
exceeds 2 bytes. Normal rules of truncation 
are used. 

WORD BOUNDING REQUIRED. 

The instruction functions only on even bounded 

addresses, but an odd address was coded. 



RELOCATABLE TERM USED 
VALUE REQUIRED. 



ABSOLUTE 



EDIT LENGTH L2 MUST BE GREATER THAN 
L1 UNLESS L2 IS ZERO. 

INVALID USE OF $SYSEG. 
$SYSEG is not allowed as an operand or sub- 
operand of any machine instruction. 
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nnnn 



AS04046 



MESSAGE TEXT 

INVALID ENTRY POINT. 

The entry point did not resolve to a relocatable 

value. Note that the line number is associated 

with the END statement because the fact cannot 

be discovered when the ENTRY instruction was 

encountered. 

MORE THAN 175 SEG DIRECTIVES 
ENCOUNTERED - FIRST 175 USED. 
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ASSEMBLER ABORT MESSAGES 

The MRX/OS Assembler abort messages are printed as the final line(s) of the listing. The 
assembly is aborted when any of these messages appear. The messages and their explanations 
are given below. The format of the messages is exactly as presented. 



MESSAGES 

ERROR IN PHASE CALL. 
Assembler in error. 

ERROR IN I/O HANDLING. 

INPUT BLOCK SIZE EXCEEDS MEMORY AVAILABLE. 

The partition size is too small to handle the larger input block size. Increase the partition 

size for this input file. In 8K, the maximum input block size allowed is 86 bytes. 

PARTITION-SIZE LESS THAN 8K BYTES. 

The Assembler requires a minimum of 8K bytes to run. 

SYMBOL TABLE ERROR. 
Assembler in error. 

SYSTEM MACRO BLOCK SIZE TOO LARGE (GREATER THAN 86 BYTES). 

END OF INPUT OCCURRED WHILE PROCESSING A MACRO - MEND STATEMENT 

MISSING. 

Either an end of input or an END statement was detected while a macro definition was 

being processed. 

FATAL ERROR IN ICTL STATEMENT PARAMETER. 

In an JCTL statement, the first parameter is less than 1 or greater than 40, or the second 

parameter is less than 40 or greater than 120. 

^^ M ^Io R ERROR IN COLUMN xx IN STATEMENT *. . .insert. . .* 
DELIMITER 

PARAMETER CARD ERROR - JOB ABORTED. 

On a //PAR statement, either a parameter or a delimiter is in error. The contents of the 
//PAR statement, but not the characters //PAR, are printed as an insert between the 
asterisks. The column number, xx, indicates the erroneous character, column 1 being the 
first character between the asterisks. Several parameter or delimiter errors may be listed in 
succession before the PARAMETER CARD ERROR message. 

FATAL ERROR IN ICTL STATEMENT SYNTAX. 

The ICTL statement parameters must be separated by a comma and terminated by a space. 
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SPECIFIED IMEM NOT FOUND IN LIBRARY. 

Either the member name does not exist or the wrong library name was used. 

MEND STATEMENT MISSING IN SYSTEM MACRO. 

While processing a system macro definition an end of input was detected, but not a MEND 
statement. Check if the system macro library has been destroyed or if just one macro was 
incorrectly written on it. 

BINARY REQUESTED - BUT OMEM1 NOT SUPPLIED. 

A member name must be provided so that the binary may be entered in the object library 

under that name. 

OPERAND MISSING IN ICTL STATEMENT. 
An ICTL statement requires an operand entry. 



SYSTEM MESSAGES 

The following system messages cause the assembler to abort. 

ERROR CODE MESSAGE TEXT 

5021 ILLEGAL BLOCK NUMBER. 

If the assembly process has not reached the print phase, the most 
probable cause is too small an allocation of MAXSIZ. Another 
possible cause is too small a file allocated for OMEM2. 

If the assembly process has reached the print stage, the most 
probable cause is that the binary file (OUTPUT1 ) has been filled. 

21 nn These errors are probably caused by an error in the Control Language 

statements. 

24nn These errors are probably caused by an error in the Control Language 

statements. Error 2109 indicates too large a MAXSIZ as a probable 
cause. Error 240B indicates that one or more of the user-supplied 
files is noncontiguous. The file with multiple extents must be 
recreated as a contiguous file. 
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LITERALS 

A literal term is used to introduce data into a program. The formats of a literal term are as 
follows. 



=a 

=a(b,c) 
=a(b) 
=a(,c) 



Where: 



a = Data value to be generated (required); any legal expression 
except another literal term. 

b = Length specification (in bytes): a positive absolute expres- 
sion. If omitted, the length specification is the implied size 
of the expression. 

c = Repetition factor; a positive absolute expression. If omitted, 
a repetition of 1 is assumed. If the size or length is specified 
symbolically, the symbol must have been previously defined. 



Examples of literals are shown in Figure 2-9. 



==C'ABD' 

=CABD'(4,3> 

=A+B/2+4 

=P'-446'(6) 
=X'FF00'(,3) 



Invalid: literal cannot define another literal. 

Valid: same as =C'ABD ABD ABD' 

Valid: implied length is the length of symbol A; implied 
repetition factor is 1 . 

Valid: specified length is 6; implied repetition factor is 1. 

Valid: implied length is 2; specified repetition factor is 3. 



Figure 2-9. Examples of Literals 



The assembler generates the literal data, stores this data in a literal pool, and places the 
address of the stored data in the operand field of the statement using the literal. The 
position of the literal pool may be controlled by the programmer with the LTORG 
assembler statement. If LTORG is not specified at the end of a control section, the literal 
pool for that segment is placed at the end of the first control section. 

A literal can be defined at any point in a program by specifying the literal in the operand of 
the statement in which it is used. In contrast, data definition statements define and label 
data, and then the label is used to specify the data. 

A literal may not be combined with any other term, nor may a literal be used as a receiving 
field of a statement that modifies storage. 

Literals are relocatable, because the address of the literal, not the literal itself, is assembled 
into the statement using the literal. 
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A,BHCD,52,;HERE HERE is a comment. The four operands are: 

CON [A ] [BHCD ] [52 ] and [CON] . 



Blank 

A blank signifies the end of the operand field. Characters following a blank are considered 
comments. 



SUBLISTS IN MACRO INSTRUCTIONS 

To group a number of suboperands as a single symbolic parameter value, the macro 
instruction operand is written as a sublist. A sublist consists of one or more suboperands 
separated by commas and enclosed in parentheses. Each suboperand has form identical to an 
operand. The entire sublist including the parentheses is considered one macro instruction 
operand. 

Omitted suboperands have a null value. However, the operand ( ) is considered a character 
string, not a sublist with all the suboperands omitted. The operand limit of 127 characters 
applies to the entire sublist. Examples of valid sublists are: 

(A,2,4,16) Four suboperands 

(A+40,B(2,6),(N,M),240/C+X) Four suboperands 



SUBLISTS IN MODEL STATEMENTS 

In a macro instruction operand, a sublist can assign a set of values to a single symbolic 
parameter of the macro definition. Any model statement may reference the entire symbolic 
parameter, but only a SETA, SETC, or ADO statement can reference the suboperands of the 
symbolic parameter. 

The format used to reference a suboperand is: symbolic parameter (n). 

The subscript n is an arithmetic set expression that refers to the position of the suboperand 
being referenced. For example, &LIST(2) references the second suboperand of the symbolic 
parameter, &LIST. 

If the sublist (A„C20,'192',(N,M)) is a macro instruction operand corresponding to the 
symbolic parameter &FIEL D, the values assigned to the suboperands are: 

FIELD(0) = null 

FIELD(1) = A 

FIELD(2) = null 

FIELD(3) = C20 
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FIELD(4) = '192' 

FIELD(5) = (N,M) 

FIELD(6) through FlELD(n) = null 

A subscripted reference to an omitted sublist element, such as FIELD(2) above, is assigned a 
null value. If the macro instruction operand is a simple operand, rather than a sublist, the 
macro instruction can refer to the operand value by the symbolic parameter without a 
subscript, or by the symbolic parameter with a subscript of 1. All other subscripted 
references have a null value. 

Suboperands of sublists within a sublist (for example, N in FIELD(5) above) cannot be 
referenced in a model statement. 

SUBSTRING NOTATION 

Substring notation allows the programmer to reference part of a macro instruction operand 
or a character string constant. Substring notation consists of a symbolic parameter or a 
character string constant, immediately followed by two arithmetic set expressions separated 
by a comma and enclosed in parentheses, as in the examples: 

&NAME(2,4) 

C'AB24CFG'(&P1,2) 

The first expression indicates the position of the first character to be included in the 
substring. The second expression indicates the number of consecutive characters (beginning 
with the character indicated by the first expression) to be included in the substring. 

If the substring specifies more characters than are in the macro instruction operand or in the 
character string constant, only the number of available characters are supplied. If the 
starting character is outside the range of the string, a null character is supplied. 

Substring notation has the following limitations: 

1. Substrings can only be specified for character string constants and 
macro instruction operands. 

2. A substring of a sublist cannot be specified. 

3. A substring reference can only be used as a term in a conditional 
assembly statement. 

Consider the example in Figure 10-4. 
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The operand field may contain an arithmetic set expression or one of the following 
character terms: 



Term 

Symbolic parameter, including sublist 
and substring references 

SETC symbol, including substring 
references 

Substring of a character constant 

&SYSECT reference 

Character constant 

&SYSNDX reference 



Example 
&PARM2(3) 

&SET1 

C'ABCDE'(2,3) 
&SYSECT 
C'ABCD' 
&SYSNDX 



Only one operand is allowed. The maximum size of an assigned character value is 16 bytes. 
If a larger value appears, only the leftmost 16 bytes are assigned by the assembler. 

When &SYSNDX is used as a single character term, the value is a string of four characters, 
including leading zeros. If the operand specified is an arithmetic set expression, the 
arithmetic value is converted to a 16-bit constant. 

Examples of valid SETC operands are: 

C24BK' 

&P1 

&P1(2,4) 

&P1&P2(2,1) 

&SETC 

&SYSECT 

&SYSNDX 

(&SYSNDX+10-&P1(2,4)/2)*&P2(2)<EQ>C'FID' 

Examples of invalid SETC operands are: 

X' 1 24' String constant other than a character constant 

C'AB2'+4 Character constant used as arithmetic operand 

ALPHA Ordinary symbol 

L'ALPHA Length attribute 
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GBLA AND GBLC - GLOBAL ARITHMETIC AND CHARACTER SET SYMBOLS 

Local set symbols are made global (available outside the macro) by a GBLA or GBLC 
statement. The format of the GBLA or GBLC statement is: 



Name 


Operation 


Operand 


Blank 


GBLAand 
GBLC 


1-35 set symbols, 
separated by commas 



Global statements must appear immediately after a prototype statement or after another 
global statement. Any number of continuation lines may be used. 

When a set symbol is declared global, its assigned value is available to statements in the main 
program, but not to other macro definitions. To be available to other macro definitions, the 
set symbols must also be declared global in those macro definitions. 

If set symbols have not been assigned values outside this macro definition or by a previous 
call to this definition, the global statement assigns an initial value of to SETA symbols and 
a null character value to SETC symbols. If the set symbols have an assigned value, the global 
statements do not affect the value of the set symbols. 



ADO -ITERATIVE RETURN 

The ADO statement sets up a loop between the ADO statement and a subsequent statement 
identified in the ADO statement. The format of the ADO statement is: 



Name 


Operation 


Operand 


Sequence 
symbol, set 
symbol, or 
blank 


ADO 


Positive arithmetic set 
expression, sequence symbol 



The sequence symbol in the name field can only be referenced by an AGO statement. 

The operand field must have two operands, separated by a comma. The first operand is a 
positive arithmetic set expression that indicates the number of iterations to be executed. 
The second operand is a sequence symbol that specifies the last statement of the loop. This 
sequence symbol must appear in the name field of a statement that follows, not precedes, 
the ADO statement. The sequence symbol cannot be in the name field of another ADO 
statement, a macro instruction, or an AGO statement. 

If the set expression is equal to zero, control is transferred to the statement named in the 
second operand, and no intervening code is included. However, if the first operand is a 
positive number, the assembler subtracts 1 from the first operand and includes in the 
assembly all the code from the ADO statement to the statement named in the second 
operand. If the first operand is zero after the subtraction, the assembler does not return to 
the ADO statement but processes the next statement. If the first operand is not zero after 
the subtraction, the assembler again subtracts 1 from the first operand and repeats the loop. 
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Notice that when the first operand initially is zero, the jump is made to the statement 
named in the second operand. When the first operand is not initially zero, the indicated 
number of loops is performed and a jump is made to the first statement after the statement 
named in the second operand. If the first operand is invalid, the value is set to 1 . 

The name field may contain a sequence symbol, a set symbol, or a blank. If the name field 
contains a set symbol, the symbol is initially assigned a value of 1. For each iteration, this 
value increases by one while the first operand of ADO decreases by one. Thus, in the 
following example, after 10 iterations, the first operand is and &COUNT is 10. 



NAME 




OPERATION 




OPERAND 


12 3 15 6 7 8 


9 


10 11 12 13 14 lb IB 17 


18 


19 20 21 22 23 24 25 26 27.28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 


4 COUNT 




ADO 




i0^,jm>. .„ . . _ _ 




-^ l — ------ 






t .,. , I .... . L_._l 4 j. .J ._, 1 , , , , 1 , , 



The preceding statement performs a function equivalent to the following three statements. 
During the first iteration, &COUNT equals 1 and the first operand (10) is decreased by one. 
After 10 iterations, &COUNT equals 10 and the first operand equals 0. Control is then 
transferred to the first statement following the .END statement. 



NAME 




OPERATION 




OPERAND 


12 3 4 5 6 7 8 


9 


10 11 12 13 14 15 IE 17 


18 


19 20, 21 22 23 24 25.26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 


iCOUHT 




SETA 

ADO 

SEJ*A 


- 





Uf^EHb ___._ . _ _ _ . 




.. 1 .._!_ .! L...J i l.._^...l .1. ..i ._!.._, J... _ J.._l..__i _1 | !. ... !__ L i__, , l_.j J._ a | , , | 



The ADO statement can be used to include or exclude code from the assembly, depending 
upon the value of the first operand, as in the following example. If the variable symbol 
&LABEL is equal to YES, the first operand of the ADO statement is 1, and all intervening 
code is included in the assembly. If, however, &LABEL is not equal to YES, the first 
operand is zero and all intervening code is excluded. 



NAME 




OPERATION 




OPERAND 


12 3 4 5 6 7 8 


9 


10 11 12 13 14 15 16 17 


18 


19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 


tSEXX. 

-» n 1 




ad a _ 

AHOP . 




4kAML<£Q>C '.YE.& * ,.,. . A 1 









... 


ii i i i i i i i i i i j i ■ i i . i i i * i i i ... i i i i i i 
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NESTING OF ADO STATEMENTS 

As many as six ADO statements can occur within a primary ADO loop. Such nesting of 
ADO statements increases the total number of iterations in geometric progression. If five 
iterations are performed by an outer ADO loop, an inner ADO with five iterations increases 
the number of iterations to 25. An inner ADO statement cannot reference a statement 
outside one referenced by the outer ADO. 

The following statements produce a 5 x 5 matrix containing all products of the ordinary 
numbers 1 through 5. 



12 3 4 5 6? 



COL, 
£NJ> 



OPERATION 



10 11 12 13 14 15 16 17 



A1>A 



ADO 
WDD 



13 20 21 22 23 24 25.26 27 28 29 30, 31 32 33 34 35 36 37 38 39 40 41 42 43 44 4546 47 48 49 50, 



4COi.*£RGM 



During the first iteration of the outer ADO (named &COL), &COL equals 1 and &ROW 
increases by 1 with each iteration of the &ROW ADO statement until &ROW equals 5. 
During this first iteration, the statement .END WDD &COL *&ROW produces the values 1, 
2, 3, 4, and 5, as shown in the first column of values in this matrix. 

First Pass of the Outer ADO 

&COL 
12 3 4 5 



1 
2 
&ROW 3 
4 
5 



1 
2 
3 
4 
5 



During the second iteration of the outer ADO, &COL equals 2 and &ROW again equals 1 
through 5. The second column of values is produced. 



Second Pass of the Outer ADO 






&COL 




1 


2 3 4 


1 


1 


2 


2 


2 


4 


&ROW 3 


3 


6 


4 


4 


8 


5 


5 


10 
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11. CONTROL LANGUAGE STATEMENTS 



The Control Language for the assembler must provide the following four basic services: 

1 . Call the assembler into execution 

2. Specify the assembly options 

3. Define source input, object output, source output, and macro library 
input files 

4. Obtain the source program from the card reader, library member, or 
spooled input 

The Control Language statements for the assembler are explained below. For the exact 
format of the statements, consult the MRX/OS Control Language Services, Extended 
Reference manual. 



Control 

Language 

Statement 

//EXEC PGM= 

//PAR 

//PAR IMEM= 



Parameter 
ASM 
Keyword options 

Input-member-name 



Description 

Calls the assembler into execution. 

Specifies the assembly options in 
free form. 

Specifies the name of the input source 
module on the library. If omitted, the 
source is assumed to be a non- 
partitioned sequential data file (such 
as a spooled input file). 
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Control 

Language 

Statement 



Parameter 



Description 



//PAROMEM1 = 



//PAR OMEM2= 



Output-member-name 



Punch-indicator 



Specifies the name of the relocatable 
object module on the library. If 
omitted and OBJECT=YES or COND, 
the assembly is aborted. 

1-10 alphabetic characters to indicate 
that PUNCH output is expected. If 
omitted, no PUNCH output is produced. 



//PAR MAXSIZ= 



1-5 decimal digits 



//PAR LIST= 



//PAR XREF= 



//PAR ERROR= 



(YESl 
I NO I 



(YESl 
I NO I 



{YESl 
(NO f 



//PAR OBJECT= 




Specifies the approximate number of 
source lines generated in the program. 
If omitted, the default value is the 
SYSGEN parameter, usually 1000. 

Specifies whether the source program is 
to be listed: 

YES List source program 
NO Omit listing 

If omitted, the default parameter is 
YES. 

Specifies whether a cross-reference list 
is to be generated: 

YES Generate cross-reference list 
NO Omit cross reference list 

Specifies whether warning errors are to 
be listed: 

YES List warning errors 
NO Omit listing 

If omitted, the default parameter is YES. 
Fatal errors are always listed. 

Specifies under what conditions a relocatable 
object module is to be generated: 

YES Module is generated unconditionally 
NO Module is not generated 
COND Module is generated if no fatal 
error occurred 

If omitted, the default parameter is YES. 
If the option, YES or COND, is selected, 
the OMEM1 option must be specified. 
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Control 

Language 

Statement 



Parameter 



Description 



//DEF ID= 



//DEF ID= 



File identifier 



INPUT 



Defines the source input, object output, 
source output, list output, and macro 
library input files. 

Source input file 



//DEF ID= 



OUTPUT1 



Relocatable output file: must be 252 
bytes, blocked 1 . The file must be a 
partitioned data file. The device must 
be disc. CSD=YES 



//DEF ID= 



OUTPUT2 



Source punch file identifier: must be 
80 bytes, blocked 1 . The file must be 
a non-partitioned sequential data set. 
CSD=YES 



//DEF ID= 



//DEF ID= 



LIST 



MAC LIB 



List output file: must be 132 bytes, 
blocked 1 . The file must be a sequential 
data set. CSD=NO. The file is written 
with the first character being a "native" 
mode control character for a printer. 

Macro library input: the file must be a 
partitioned data set, CSD format, 80 
byte records, blocked 1 . 



If MACLIB is not specified, the default file name is $SYSMACLIB. The INPUT and LIST 
files must always be defined; the OUTPUT1 and OUTPUT2 files are optional. DEFINE 
statements may also include keyword parameters to identify the file name or the device 
with which the file is associated. 



If the source program is to be read from the card reader, the source program card deck must 
be preceded by a //DATA Fl L=SYSCRD statement and terminated by a /* card. 
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The cards in Figure 11-1 illustrate the Control Language statements to specify: 

• Source input from cards 

• Relocatable output to a specified library member 

• List output to printer 

• Cross-reference output 




Figure 11-1. Example of Ct < Language Statements 
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2. WRITING SOURCE STATEMENTS 



To write source statements, the programmer should be familiar with the following topics: 

• Character set 

• Basic format of source statements 

• Types of terms and expressions 

• Coding form 

CHARACTER SET 

Source statements may contain the following characters: 



Letters 


A through Z, and $ 


Digits 


through 9 


Special 
Characters 


+ *& 

-(; 

,)" 

. ' blank 

= /#<§><> 



The EBCDIC formats and card punch codes for these characters are listed in Appendix A. 
Any of the 256 punch combinations may appear inside a character constant, in comments, 
or in macro instruction operands. The meanings of these characters, and combinations of 
these characters, are explained in Figure 2-1 . 
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Character 


Explanation 


Example 


A through Z, and $ 


Used in symbols and character string constants 


C'ACCOUNT NO.' 


through 9 


Used in numeric constants and symbols 


TAG3,5825 


- 


Operand or suboperand separator 


HERE.THERE 


= 


Indicates a literal term or a keyword parameter 
value 


=A+2 


C 


Defines a character constant (all characters to 
the next apostrophe) 


C'ABC 


X' 


Defines a hexadecimal string constant (all hexa- 
decimal characters to the next apostrophe) 


X'lAFEE' 


P' 


Defines a packed decimal string constant (all 
characters to the next apostrophe) 


P'425' 


Z' 


Defines a zoned decimal string constant (all 
characters to the next apostrophe) 


Z'-44' 


1' 


Defines an integer string constant (all 
characters to the next apostrophe) 


T4286' 


■■ 


Defines a hexadecimal arithmetic constant 


"FF1A 


< > 


Define relational (EQ, GT, LT, NE, LE, GE) 
and logical (NOT, AND, OR, EOR) operations 


A<EQ>B 
A<AND>B 


L' 


Defines a reference to a symbol length 
attribute 


L'SYMX 


* 


Location counter reference or multiplication 
indicator 


*+4 
12*20 


/ 


Division indicator (Note that 1/2=0 because 
division always results in an integer, not a 
fraction.) 


10/0 
TAG/B 


+ 


Addition Indicator 


TAG+12 


- 


Subtraction Indicator 


TAB-4 


& 


Defines a variable symbol 


&TAC 


() 


Separates an address-modifying index from the 
rest of the address, delimits sublisted operands, 
or encloses operands or suboperands 


PAG(R2> 




Used for sequence symbols and concatenation 


.LAST 


* 


Used for macro definition comments 


.•COMMENT 


# 


The character following this symbol is to be 
evaluated for its literal value, not for its special 
function. In the example, the symbol following 
the # sign is a semicolon, not a continuation 
indicator. 


C'24#;4' 


\ 


Continuation indicator 


THE STATEMENT IS; 


<a 


Indirect Addressing 


@REG1,@TAG1 


blank 


field separator 


ADDR 3,4 



Figure 2-1. Character Usage 



2-2 



BASIC FORMAT OF SOURCE STATEMENTS 

Source program statements have the fields outlined in Figure 2-2. 



Name 


Operation 


Operand 


Comment 


Any symbol 
or blank 


Machine instruction, 
assembler instruction, 
macro instruction, or 
FORM instruction 


Single expression, 
several expressions, 
or blank 


Informational material 
or blank 



Figure 2-2. Source Statement Format 



The name field entry is a symbol used to identify a statement. The name field is necessary 
for certain statements, or when the statement is referred to in another statement, such as in 
a Branch instruction. 

The operation field entry is a predefined mnemonic code (or mnemonic) which identifies 
the function of a machine, macro, assembler, or FORM instruction. Mnemonics are designed 
to be easily learned and remembered; for example, ADDR for Add Register- Register, or 
EQU for an Equate assembler instruction. 

The operand field entry defines or identifies the data involved in the operation. Most 
statements have one or more operands, although some statements have no operands at all. 
Each operand has one or more terms, which may be used in a combination to form one or 
more expressions. (Refer to immediately following text for a discussion of terms and 
expressions.) An operand field may not have more than 35 terms. Operands of machine 
statements generally represent storage locations, general registers, immediate data, or 
constant values. Operands of assembler statements provide the information necessary for the 
assembler to perform the designated operation. 

The optional comment field contains any informational material the programmer wishes to 
add. 



TERMS AND EXPRESSIONS 

A term is a symbol, character, or number that represents a value; an expression is a single 
term or a combination of terms. An expression is used in the operand field of a source 
statement. The following text fully defines terms and expressions. 
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TERMS 

Every term represents a value; the value may be assigned by the assembler program (symbol, 
symbol length attribute, location counter reference) or may be inherent in the term itself 
(constant, literal). 

An arithmetic combination of terms is reduced to a single arithmetic value by the assembler. 
An arithmetic value is represented as a 16-bit binary value in two's complement form. A 
logical value has a range of through 65,535; and an arithmetic value has a range of 32,768 
through 32,767. Limitations on the value of an expression depend on its use. For example, a 
term designating a general register must have a value between 0-7 inclusively; a term 
representing an address must not exceed the size of storage. 

A term is absolute if its value does not change upon program relocation. It is relocatable if 
its value changes upon program relocation. 

The terms used in assembler statements are outlined in Figure 2-3. An explanation of each 
type of term and the rules for its use are provided in the following text. 







Character String 








i Constant 


C'ABC 






1 Hexadecimal String 








1 Constant 


X'C49FE' 






/ Packed Decimal 






/ String Constants 


\ String Constant 
I Zoned Decimal 


P'-244' 




\ j 


I String Constant 


Z'246' 




/ 


Integer String 




Constants 


J ' 


Constant 


l'-323' 




I Arithmetic 
\ Constants 


1 Decimal Arithmetic 
\ Constant 

] Hexadecimal Arithmetic 


2316 






1 Constant 


"2FA 




/ Ordinary Symbols 


1 






\ 


1 Symbolic Parameter 


&TAB1 


Symbols 


/ Variable Symbols 


/ System Variable Symbols 


&SYSNDX 




I 


/ Set Symbols 


&TAB3 




1 Sequence Symbols 


\ 




Location 








Counter 








Reference 


*-20 






Symbol 








Length 








Attribute 


LTAB1 






Literals 


=HERE 







Figure 2-3. Types of Terms 



2-4 



CONSTANTS 

Constants are terms whose values are inherent in the' terms themselves. They specify 
machine values or bit configurations directly, rather than by equating the values to symbols 
and then using symbolic references. Constants represent such program elements as 
immediate data, masks, registers, addresses, and address increments. 

Constants are string or arithmetic. String constants are of variable size; arithmetic constants 
are 16 bits long. Examples of all types of constants are presented in Figure 2-6. 



String Constants 

A string constant can only be used as a single term expression, or in a relational expression. 
In a relational expression, both terms must be of the same type (character, hexadecimal, 
etc.), for example: C'ABCE'< LT>C'&P1'. 



Character String Constant 

A character string constant is written as the letter C followed by a character string enclosed 
in apostrophes, for example: C'STRING'. To represent the literal value of an apostrophe, an 
ampersand, a semicolon, or a pound sign as part of the character constant, the character 
must be immediately preceded by an escape character, which is the pound sign. The length 
of a character constant is equal to the number of characters in the constant, excluding the 
escape characters, which do not appear in storage. 

Examples of character constants are shown in Figure 2-4. In the last example of Figure 2-4, 
the generated code is: THIS CHARACTER STRING HAS MANY SPECIAL CHARACTERS 

IN IT: #;'&. 



OPERAND . 



19 20 2122232425262728293031 32, 33 34 35 36 37 38 39 40,41 42 43 44 45,46 47 48 49 50,51 52 53 54 55.56 57 58 59 60,61 62 63 64 65,66 67 68 69 70.71 



C ' THIS XSl A M6J&M6 e ' 



3LS 



THIS £MA£A.C,TE,R. STRLWk}. 



TV^S. £MA.eACT£JL ST 8L3.M&* iXS. NOT. £fiimitM£.D. 1 . 






C,' THIS .STRING HAS. MANX SPECIAL .C.ttA£S-£H ll:#*l 



»*' 



Figure 2-4. Character Constants 
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If the following characters are not preceded by an escape character in a character constant, 
they have the meaning given below: 

Character Meaning 

; A character constant is continued on the next line 

Encloses the characters of a character constant 

& Variable symbol 

# Next character retains its literal value 

Hexadecimal String Constant 

A hexadecimal string constant is written as the letter X followed by a string of hexadecimal 
digits enclosed in apostrophes, such as: X'C49FE'. Each hexadecimal digit is translated into 
its four-bit equivalent. The maximum size of a hexadecimal string constant is limited to the 
maximum number of digits that can be contained on two coding lines. If an odd number of 
digits is specified, the leftmost four bits in the leftmost byte are set to zero. The implied 
length of the constant is half the number of hexadecimal digits in the constant, rounded to 
the next higher integer. 

Packed Decimal String Constant 

A packed decimal string constant is written as the letter P followed by a signed integer 
number enclosed in apostrophes, such as: P'-244'. If the sign is omitted, the number is 
assumed to be positive. Each pair of decimal digits is translated into one byte. The rightmost 
byte of a packed field contains the rightmost digit and the sign. Signs generated are "C-|6" 
for plus, and "D-\q" for minus. The maximum length of a packed decimal string constant is 
limited to the number of digits that can be contained on two coding lines. 

Zoned Decimal String Constant 

A zoned decimal string constant is written as the letter Z followed by a signed integer 
number enclosed in apostrophes, for example: Z'246'. If the sign is omitted, the number is 
assumed to be positive. Each decimal digit is translated into one byte. The rightmost byte 
contains the sign and the rightmost digit. Signs generated are "C-\q" for plus, and "D-|6" for 
minus. The maximum length of a zoned decimal string constant is limited to the number of 
digits that can be contained on two coding lines. 

Integer String Constant 

An integer string constant is written as the letter I followed by a signed integer number 
enclosed in apostrophes, such as: T-246'. If the sign is omitted, the number is assumed to be 
positive. An integer string constant is translated into its four-byte binary equivalent. Integer 
constants consist of 1-10 digits with a value ranging from -231 to 231-1. The constant is 
word aligned when used in a WDD statement or a literal. 
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When string constants define data in storage, truncation and padding of their values is 
performed according to the rules presented in Figure 2-5. 





Explicit Length= 


Explicit Length > 


Explicit Length < 


Constant 


Implicit Length 


Implicit Length 


Implicit Length 


Character 


C'ABC'(3)=ABC 


Left justify. 


Left justify. 






Blank fill on right. 


Truncate on right. 


C'ABC 




C'ABC'(4)=ABC 


Warning message is given. 
C'ABC'(2)=AB 


Hexadecimal 


Right justify. 


Right justify. 


Right justify. 




Zero fill on left if the 


Zero fill on left. 


Truncate on left. 


XI OA' 


constant contains an 




Warning message is given. 




odd number of digits. 


X'10A'(3)=00010A 


X'10A'(1)=0A 




X'10A'(2)=010A 






Packed 


Right justify. 


Right justify. 


Right justify. 


Decimal 


Zero fill on left if the 


Zero fill on left. 


Truncate on left. 




constant contains even 




Warning message is given. 


P'-24' 


number of digits. 
P'-24'(2)=024D 


P'-24'(3)=00024D 


P'-24'(1)=4D 


Zoned 


Z'123'I3)=F1F2C3 


Right justify. 


Right justify. 


Decimal 




Zero fill on left. 


Truncate on left. 
Warning message is given. 


Z'123' 




Z'123'(4)=F0F1F2C3 


F'123'(2)=F2C3 


Integer 


Right justify. 


Right justify. 


Right justify. 




Propagate sign on left. 


Propagate sign on left. 


Truncate on left. 


I '-758' 






Sign is lost. 




I'-758'(4)=FFFFFD0A 


l'-758'(6)= 

FFFFFFFFFDOA 


Warning message is given. 
I'-758'(1)=0A 



Figure 2-5. Truncation and Padding of String Constant Values 



Arithmetic Constants 

Arithmetic constants can be used in multi-term expressions. An arithmetic constant is 
assembled as its two-byte binary equivalent. The maximum size of an arithmetic constant is 
216-1. |f arithmetic constants are used in statements where an explicit size is specified, 
truncation and padding follow the same rules as those for an integer string constant. 



Decimal Arithmetic Constant 

A decimal arithmetic constant is written as an unsigned integer number of 1-5 digits, for 
example: 20. 
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Hexadecimal Arithmetic Constant 

A hexadecimal arithmetic constant is written as quotation marks followed by a string of 1-4 
hexadecimal digits, for example: "2FA. Each hexadecimal digit is assembled as its four-bit 
binary equivalent. 



Type 


Example 


Generated Hexadecimal Code 


Character String 


CF12AY9*' 

C'$Z#'##5" 
C'B' 


C6F1F2C1E8F95C 

5BE97D7BF5 

C2 


Hexadecimal String 


X'C49FE' 

X'F2' 

X'C 


0C49FE 

F2 

OC 


Packed Decimal String 


P'14' 

P'925860' 
P'-2' 
P'-2596' 


01 4C 
0925860C 
2D 
02596 D 


Zoned Decimal String 


Z'14' 
Z'925860' 
Z'-2' 
Z'-2596' 


F1C4 

F9F2F5F8F6C0 
D2 
F2F5F9D6 


Integer String 


l'14' 

I '925860' 

l'-2' 

I--2596' 


00 00 00 0E 
00 0E 20 A4 
FFFFFFFF 
FFFFF5DC 


Decimal Arithmetic 


14 

302 

57399 


000E 
01 2E 
E037 


Hexadecimal Arithmetic 


"14 

"F2A 

"E09F 


0014 
0F2A 
E09F 



Figure 2-6. Examples of Assembled Constants 



SYMBOLS 



A symbol is a character or combination of characters used to represent locations or arbitrary 
values. Symbols, through their use in name fields and operands, provide the programmer 
with an efficient way to name and reference a program element. A symbol is defined when 
it appears in the name field of a source statement. 
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If duplicate literals are specified within one literal pool, only one literal is stored. Literals 
are duplicate if their final specifications, size, and repetition factors are identical on a 
character-by-character basis. A literal may be a duplicate even when it appears to be 
different (see examples in Figure 2-10). A literal is a duplicate if it contains no forward 
references and the expressions evaluate to the same value as the corresponding expressions 
of an existing literal. 

A literal which contains a reference to the location counter is stored even if it duplicates 
another literal (see examples). If an expression used in a literal term contains a forward 
reference to a symbol, the symbol is assumed to represent a two-byte value. 



Examples of duplicate literals are shown in Figure 2-10. 



=C'ABC(4,3) 
=C'ABC(4,3) 

=C'ABC 
=X'C1C2C3' 

=A+B 
=B+A 

=C<EQ>D 

=*+10 
=*+10 



Only one literal is stored. 



Both literals are stored. 



Only one literal is stored if A and B are predefined symbols. 



Only one literal is stored if C is defined to be equal to D, so that the 
expression is equal to 1. 

Both literals are stored 



Figure 2-10. Examples of Duplicate Literals 



EXPRESSIONS 

An expression is defined as one or more terms linked by arithmetic, relational, or logical 
operators. Expressions may be single term or multi-term (see examples below). 



J>ingle Term Expressions 

29 

"F0 

SYMX 



L'SYMX 
P'-240' 



Multi-Term Expressions 

SYMX+40 

A+B/2+10 

(X< OR >"F0F0)< EQ >(SP2<OR >"F0F0) 

(«A+4)/2+1)*2<AND>"00FF)<EQ>24) 

*+L'BETA 

A+B<LE>SUM 
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If the length specification or the repetition factor is zero, no data is generated, but the 
location counter is aligned on the specified word or byte boundary. 

Examples of WDD and BDD statements are shown in Figure 8-2. In the last example, if M = 
N, the term 35 is generated. If M = N, no data is generated, but the location counter is set 
on a word address, which is given the name NAM4. 



NAME 




OPERATION 




OPERAND 


12 3 4 6 6 7 8 


9 


10 11 12 13 11 10 16 17 


18 


19 20 21 22 23 24 25 20 27 28 29 30 31 32 33 34 36 36 37 38 39 40 41 42 43 44 46 46 47 48 49 50, 


MAH3 

turn : 




bj>j) : : 

bm> : : 




cmm is'Ct 

-XV-i^B' * 
7C,Btl) 


) 










...... 


.. . X. 

i 




■ 


.. 1 



Figure 8-2. Examples of WDD and BDD Statements 



The value attribute of the symbol in the name field is the address of the leftmost byte after 
alignment. The length attribute is the length in bytes (specified or implied) of the first (or 
only) data field in the operand. 

Omitted operands, signified by a comma without a data value, indicate a zero byte or word. 
The last data value in a string of multiple operands must be a specified data value, not an 
omitted operand. 

Consider the following example. Notice that an arithmetic constant, such as 45, uses two 
bytes. 



Statement 



WDD ,12, ,,45 



Generated Data 

00 00 Word 1 

00 OC Word 2 

00 00 Word 3 

00 00 Word 4 

00 2D Word 5 



If the data value is a relocatable expression other than $SYSEG, the length specification and 
the repetition factor have the following restrictions: 

1. The length attribute must be resolved to two bytes. If the length is 
not specified, two bytes are assumed. 

2. Alignment must be on a word boundary. 

For $SYSEG, the length attribute is 1 and alignment must be on an odd boundary. 
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Literals (which are always relocatable) in a WDD or BDD statement require special 
consideration. If a literal term is used in the WDD or BDD statement, the implied length and 
repetition attributes are (2,1). If other specifications are included, they refer to the literal 
term itself, but not to the symbol defined in the name field. Consider this statement: 



NAME 




OPERATION 




OPERAND 


1 2 3 4 5 G 7 8 


9 


10 11 12 13 m 15 16 17 


18 


19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 


R| 




WBJ) 




•C'ABCftVC^JL) 



The length attribute of the literal C'ABCD'(5,2) is 10; but the length attribute of the 
symbol B1 is 2, because the operand is a relocatable term. In all other cases, the symbol in 
the name field receives the length attribute of the first data field in the operand. 

If the location counter (*) is referenced in the operand field, the value attribute of the 
symbol in the name field replaces the operand. For example, TAG WDD *,*,* generates 
three words of data, each assigned the value attribute of TAG. If TAG is equal to to 1004, 
then 1004 1004 1004 is generated. 

For example, the following statement specifies that two 8-byte fields of all zeros are to be 
generated. TAG represents the address of the first byte of generated data. 



NAME 


9 


OPERATION 




OPERAND 


1 2 3 4 5 G 7 8 


10 11 12 13 14 15 16 17 


18 


19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 


TA& 




WDS 




0C1,1Y JfCM,*) 



If the location counter is pointing to OOFE, TAG is equal to 00FE and the storage locations 
are as follows. (The last byte is 01 OD or TAG+15.) 



Locations 


Contents 


OOFE 


00 00 


0100 


00 00 


0102 


00 00 


0104 


00 00 


0106 


00 00 


0108 


00 00 


010A 


00 00 


01 OC 


00 00 



First operand 



Second operand 



If the location counter is pointing to an odd-byte address when a WDD statement is 
encountered, the assembler automatically updates the counter to the next word boundary 
and does not affect the contents of the odd-byte address. 

In the preceding example, if the location counter is pointing to 00FD, the assembler updates 
the counter to OOFE and the contents of 00FD are unchanged. The storage locations are as 
follows. 
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5. 



Alphanumeric character constants are left-justified with blank fill on 
the right. If the actual data is larger than the defined field, the data is 
truncated on the right. 

Packed decimal values are right-justified with zero fill on the left. If 
the actual data is larger than the defined field, the data is truncated 
on the left. 

Zoned decimal values are right-justified with zero fill on the left. If 
the actual data is larger than the defined field, the data is truncated 
on the left. 

Integer string values and arithmetic values are right- justified with the 
sign propagated on the left. If the actual data is larger than the 
defined field, the data is truncated on the left and the sign is lost. 



The examples in Figure 8-4 illustrate certain padding and truncation rules. The first operand 
of TAB1, a hexadecimal 5 (0101), is truncated on the left and the two rightmost bits (01) 
are inserted in the 2-bit field defined by 2 in the FORM definition statement. If the value 
attribute of B in the second operand is less than C, the single bit position established in the 
corresponding definition statement is set to a binary 1 . If B is greater than C, the bit is set to 
a binary 0. 

The first A character constant (1100 0001 in EBCDIC) in the second TABLE statement is 
truncated on the right, and the remaining two leftmost bits (11) are assigned to location 
TAB2. Note, however, that all eight bits (1 100 0001 ) of the second A character constant in 
the fourth operand position aire retained at location TAB2+1. 



NAME 




OPERATION 




OPERAND 


12 3 16 6)8 


9 


10 11 12 13 14 15 16 17 


18 


19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 


TABLE 

TM\ 

TABA 




FJDftM 

FABLE . 
TABLE 




cvAv^evA' . 



Figure 8-4. Examples of Padding and Truncation for Form Statements 



The following examples show a possible use of the FORM statement — redefining 
instructions to create a new language closer to English. In the first example, the "MOVE" 
instruction generates a MOVM machine instruction, using a FORM statement and a series of 
Equates. This corresponds to: MOVM BUFFERB(R2),@BUFFERA(R3). Assuming that 
BUFFER A is at address 63FA, the code generated is: 

602B 

63FA 

63FC 
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12 3 4 5 6 7 



&XRECT 
LMBXRECTI 

R3 

MEMORY 

mMJL 

BUFFERA 

RUF.EERB 



OPERATION 



10 11 12 13 14 15 IB 17 



E&U 

EQU 

EQU 

EQU 

EOU 

FORK 

W3>]> 

Wfcb 

HOVE 



19 20 21 22 23 24 25 26 27 28 23 30 31 32 33 34 36 36 37 38 39 40 41 42 43 44 45 4647484950 



. 
L . 

1 . 
3 

a,. i.,3„ 
c • 'xa> 

WE-MORY., 
BU.FFE.RB, 



,! 



,3, I A, I 6 



i| i , _j. j. ___ .1 i J ~i i L 

._ i. .. I U-_±. J ■ _,,■ 1 -L 1 L 

.._i_._._J_.... l _...-. J .-— I. .. I. ...J,._...„l...-...l— - 1. ...J.-..-1. 

--*— ' — ^ — "— "-— • — L ■ l -- L L -- L 

_ _I_ J I .. I- - L J— .1 1 i—J L 



&XRECT , R2> , XM&LREGT, R3 , j 
.BjIPFERA ^ ._ _ . 



The next example shows a BRANCH FORM statement used alone to generate a BR machine 
instruction, or together with ROUTINE to generate a BSR machine instruction. Assuming 
that SUBROUT1 is at 2F3A, the code generated is: 

EA07 

2F3A 

The last statement of this example, BRANCH REGISTER, R7, generates the code: EB07. 



OPERATION 



12 3 4 5 6 7 



10 11 12 13 14 15 16 17 



19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45,46 47 48 49 50 



SAYERTH 

R7_ 

RESISTOR 

BRANCH 

ROUTINE 



SU BR OUT I 



EQU 

E&U 

EQU 

FORM 

FORJi 

BRANCH 

ROUTINE 

EOU 

BRANCH 



X\EA' . 

7 -^ 

X'EB' 

M 

SAVERTN.R7 
SUB ROUT! 

* 

REGISTER, R7 . 



_„1 J 1-. .— A- l- 



A detailed example of the FORM instruction can be found in Appendix F. 
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LINE 
NUMBER 

nnnn 



ERROR 
TYPE 



nnnn 



nnnn 



W 



W 



nnnn 



W 



nnnn 



ERROR 
CODE 

AS02042 



nnnn 


F 


AS02043 


nnnn 


F 


AS02044 


nnnn 


F 


AS02045 


nnnn 


W 


AS02046 



AS02047 



AS02048 



AS02049 



AS02051 



MESSAGE TEXT 

OPERATION ENTRY MUST BE FOLLOWED 
BY A SPACE. 

The space is the delimiter of each field in the 
MRX Assembler. 

OPERATION CODE CANNOT BE CONTINUED. 

INVALID CHARACTER IN OPERATION 

ENTRY. 

Only valid characters are A-Z, 0-9, & and $. 

OPERATION ENTRY TOO LONG. 
Only 8 characters are allowed if there is no 
substitution in the operation entry. 

INVALID ISEQ PARAMETERS - COMMAND 
IGNORED. 

1 . The parameter value is within the begin 
and end limits in the statement. 

2. The length of the sequence field is zero. 

3. The length of the sequence field is greater 
than 8 characters. 

MISPLACED ICTL STATEMENT. 

An ICTL statement must be the first statement 

of an assembly. 

STATEMENT VAL ID ONLY WITHIN A 

MACRO. 

The following operation codes are allowed 

within a macro definition: 

GBLA 

GBLC 

MACRO 

MEND 

MNOTE 

MEXIT 

INVALID OR MISPLACED INSTRUCTION IN 
MACRO DEFINITION. 
The following operation codes are not allowed 
within a macro definition: 

PRINT 

ISEQ 

MACRO 
Also GBLA, GBLC must immediately follow the 
macro definition prototype. 

INVALID CONTINUATION. 

The continued statement has a continuation 

character as the first nonblank character. 
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LINE 


ERROR 


ERROR 


NUMBER 


TYPE 


CODE 


nnnn 


W 


AS02052 


nnnn 
nnnn 


W 

w 


AS02053 
AS02054 



nnnn 


F 


AS02055 


nnnn 


F 


AS02056 


nnnn 


F 


AS02057 


nnnn 


F 


AS02058 


nnnn 


F 


AS02059 


nnnn 


W 


AS02060 


nnnn 


W 


AS02061 


nnnn 


F 


AS02062 


nnnn 


W 


AS02063 


nnnn 


W 


AS02064 


nnnn 


W 


AS02065 



nnnn 



W 



AS02066 



MESSAGE TEXT 

END STATEMENT SUPPLIED BY ASSEMBLER. 
End of input detected but no end card received. 

NAME FIELD OF MEND STATEMENT MAY 
ONLY CONTAIN A SEQUENCE SYMBOL. 

NAME FIELD OF MACRO DEFINITION 
HEADER MUST BE BLANK. 
The name of the operation code MACRO 
must be blank. 

REQUIRED OPERAND ENTRY MISSING. 
The operation code in the statement requires 
an operand field entry. 

SYMBOLIC PARAMETER CANNOT BE 
USED AS A GBLA OR GBLC OPERAND. 

SET SYMBOL MAY NOT BE DEFINED AS 
BOTH SETA AND SETC. 

END QUOTE MISSING. 

MACHINE AND ASSEMBLER OPERATION 
CODES MAY NOT BE USED AS MACRO 
INSTRUCTION. 

MULTIPLE DEFINITION OF MACRO 

INSTRUCTION. 

Macro instruction has been previously defined. 

NAME ENTRY OF MACRO PROTOTYPE 
STATEMENT MUST BE BLANK OR A 
VARIABLE SYMBOL. 

MORE THAN 35 SYMBOLIC PARAMETERS. 
Only 35 symbolic parameters are allowed. 

NAME ENTRY OF MACRO INSTRUCTION 
MAY NOT BE A VARIABLE SYMBOL. 

STATEMENT OUT OF SEQUENCE. 

INVALID ISEQ SYNTAX. 
In an ISEQ statement the name entry must be 
blank and the parameters must be separated by 
a comma and must be terminated by a space. 

INVALID ICTL SYNTAX. 

In an ICTL statement the name entry must be 

blank. 
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LINE 
NUMBER 


ERROR 
TYPE 


ERROR 
CODE 


nnnn 


F 


AS021 1 1 


nnnn 
nnnn 


F 
W 


AS02112 
AS02114 



MESSAGE TEXT 

REFERENCE TO DOUBLY-DEFINED 

SEQUENCE SYMBOL. 

The ADO or AGO statement is not processed. 

INSTRUCTION NOT VALID AFTER SEG 

STATEMENT. 

The instruction is not processed. 

SPECIFIED SUBSTRING - LENGTH TOO 
LARGE. 



NOTE : AS021 1 5 reserved for future use. 

nnnn F AS02116 

NOTE : AS021 1 7 reserved for future use. 

nnnn F AS02118 

NOTE: AS02119 reserved for future use. 

NOTE : AS021 20 reserved for future use. 

NOTE: AS02121 and AS02122 reserved for future use 

nnnn F AS02123 



INVALID USE OF SEQUENCE SYMBOL. 



INVALID USE OF CHARACTER STRING. 



nnnn 


F 


AS02124 


nnnn 


F 


AS02125 


nnnrt 


F 


AS02126 


nnnn 


F 


AS02127 


nnnn 


F 


AS03001 



nnnn 


F 


AS03002 


nnnn 


F 


AS03003 


nnnn 


F 


AS03004 



EXPRESSION CONTAINS INCOMPATIBLE 
OPERAND TYPES. 

EVALUATOR - STACK OVERFLOW. 

MULTIPLICATION OR DIVISION OVERFLOW. 

UNDEFINED SEQUENCE SYMBOL OR 
VARIABLE SYMBOL. 

INVALID SUBSTRING OR SUBLIST 
REFERENCE. 

OPERAND SIZE OR NUMBER OF TERMS 
EXCEEDS MAXIMUM. 
This message indicates internal stack overflow. 
To correct the condition, reduce the number 
of terms in the expression or number of oper- 
ands. 

UNMATCHED RIGHT PARENTHESIS. 

UNMATCHED LEFT PARENTHESIS. 

EXPRESSION OR SUBLIST CONTAINS AN 
INVALID COMMA. 
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LINE ERROR 

NUMBER TYPE 



ERROR 
CODE 



NOTE : AS03005 reserved for future use. 
nnnn F AS03006 



nnnn 



nnnn 



nnnn 



nnnn 



nnnn 



nnnn 



nnnn 



nnnn 



nnnn 



AS03007 



AS03008 



AS03009 



AS03010 



AS03011 



AS03012 



AS03013 



MESSAGE TEXT 



INVALID USE OF INDIRECTION 

*. . .insert. . .* 

The use of the indirect operator, @, is invalid. 

INVALID EXPRESSION *. . .insert. . .* 

The syntax does not follow the rules for 
coding expressions. 

INVAL ID USE OF LITERALS *. . .insert. . .* 
The use of the literal operator, =, is invalid in 
this statement. 

INVAL ID USE OF PARENTHESIS 
*. . .insert. . .* 

CHARACTER STRING INVALID WITH 
+ - * OR / OPERATOR *. . .insert. . .* 
Arithmetic operations are invalid with strings. 

INVALID SUBLIST *. . .insert. . .* 
The use of the sublist is invalid in this 
statement. 

RELOCATABLE TERM USED IN MULTI- 
PLICATION, DIVISION OR LOGICAL 
OPERATION *. . .insert. . .* 
The location counter, *, may not enter into 
the above mentioned operations. 

MAY NOT FOLLOW A LOGICAL, RELA- 
TIONAL OR ARITHMETIC OPERATOR 
*. . .insert. . .* 

The unary operator NOT may not follow the 
above mentioned operators. 



NOTE: AS03014 and AS03015 are reserved for future use 
F AS03016 



SYMBOL TOO LONG *. . .insert. . .* 

A name entry or a symbolic operand may not 

exceed 8 characters. 

AS03017 INVALID HEXADECIMAL CONSTANT 

*. . .insert. . .* 

A hexadecimal constant may only contain 
digits 0-9 and characters A-F. 
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LINE 
NUMBER 

nnnn 



ERROR 
TYPE 



ERROR 
CODE 

AS03018 



nnnn 



nnnn 



nnnn 



nnnn 



nnnn 



AS03019 



AS03020 



AS03021 



AS03022 



AS03023 



NOTE: AS030024 is reserved for future use. 
F AS03025 



nnnn 



nnnn 



W 



AS03026 



nnnn 



W 



AS03027 



MESSAGE TEXT 

OPERAND SIZE OR NUMBER OF TERMS 
EXCEEDS MAXIMUM *. . .insert. . .* 
This message indicates internal stack overflow. 
To correct the condition, reduce the number 
of terms in the expression or the number of 
operands. 

INVAL ID OPERATOR *. . .insert. . .* 

The operator or symbol is not in the language. 

INVALID CHARACTER *. . .insert. . .* 
The character is not in the language or is 
contextual ly incorrect. 

INVALID CONTINUATION *. . .insert. . .* 
The usage of the semicolon is contextually 
invalid. 

INVAL ID SYMBOL *. . .insert. . .* 

The length attribute operand may only be 

symbolic. 

INVALID STRING *. . .insert. . .* 
An invalid string structure appeared. 



INVALID STRING *. . .insert. . .* 
Same as AS03023 above. 

OPERAND TRUNCATED - TOO LONG 
*. . .insert. . .* 

The number of digits exceeds the maximum 
allowed. For a decimal integer, 5 is the 
maximum. For an integer string, 10 is the 
maximum. For a hexadecimal constant, 4 
is the maximum. 

VALUE TRUNCATED - EXCEEDS PER- 
MISSIBLE MAGNITUDE *. . .insert. . .* 
A decimal integer may not exceed 65,535. 
An integer string may not exceed 4,294,967,295. 



NOTE : AS03028 and AS03029 are reserved for future use 
nnnn W AS03030 



NVALID USE OF NAME ENTRY. 
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LINE 
NUMBER 

nnnn 



nnnn 



ERROR 
TYPE 



nnnn 



nnnn 



nnnn 



nnnn 



nnnn 



ERROR 
CODE 

AS03031 



AS03032 



AS03033 



AS03034 



AS03035 



AS03036 



AS03037 



NOTE: AS03038 is reserved for future use. 
nnnn F AS03039 



nnnn 



nnnn 



AS03040 



AS03041 



MESSAGE TEXT 

INVALID FORM DEFINITION. 

A form reference cannot be used as an operand 

entry. 

INVALID USE OF $SYSEG. 

$SYSEG is invalid in an evaluated expression. 

RELOCATABLE TERM INVALID WITH 
UNARY OPERATOR. 
A relocatable term may not be used in con- 
junction with a NOT operator. 

INVALID USE OF STRING CONSTANT. 
A string constant may not be used as a term 
in conjunction with an arithmetic or logical 
operator. 

RELOCATABLE TERM INVALID WITH */ 
OR LOGICAL OPERATOR *. . .insert. . .* 
A relocatable term may not be used in con- 
junction with a multiplication, division, or 
logical operation. 

INVALID SYNTAX. 

The operand structure does not follow the 

rules of the language. 

MORE THAN SIX RELOCATABLE TERMS. 
An expression may not contain more than six 
unresolved relocatable terms. 



INVALID STRING *. . .insert. . .* 

Both strings in a relational or logical operation 

must be the same type. 

OPERAND SIZE OR NUMBER OF TERMS 

EXCEEDS MAXIMUM *. . .insert. . .* 

The expression size is too large to be evaluated. 

MULTIPLICATION OR DIVISION OVER- 
FLOW *. . . insert . . .* 
Either division overflow has occurred or the 
second term of a multiplication or division 
operation exceeds a 16-bit value. 



NOTE: AS03042 is reserved for future use. 
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LINE 
NUMBER 

nnnn 



ERROR 
TYPE 



nnnn 



ERROR 
CODE 

AS03043 



AS03044 



MESSAGE TEXT 

RELOCATABLE TERM INVAL ID WITH 
RELATIONAL OPERATOR *. . .insert. . 
A relocatable term may not be used in con- 
junction with a relational operator. 

UNDEFINEDSYMBOLIC OPERAND. 
The reference is not used as a label within 
this program. 



NOTE: AS03045 is reserved for future use. 

NOTE : AS03046 through AS03050 are reserved for future use. 



nnnn 



nnnn 



nnnn 



nnnn 



AS03051 DUPLICATE DEFINITION OF NAME 

ENTRY. *. . .insert. . .» 
The name field entry definitions must be 
unique. All duplicates are discarded. 

AS03052 ENTRY POINT DEFINITION IS NOT 

RELOCATABLE *. . .insert. . .* 
The entry point definition must resolve 
to a relocatable term. 

AS03053 CSECT NAME IS ALREADY DEFINED, 

BUT NOT AS CSECT *. . .insert. . .* 
Control section names must not appear as 
ordinary name field entries. 

AS03054 COM NAME IS ALREADY DEFINED, 

BUT NOT COM *. . .insert. . .* 
COM names must not appear as ordinary 
name field entries. 



NOTE: AS03055 is the same as AS03052. 

NOTE : AS03056 through AS03058 are reserved for future use. 



nnnn 



nnnn 



nnnn 



AS03059 DUPLICATE FORM DEFINITION. *. . .insert. 

The form definition name entry is previously 
defined. 

AS03060 INVALID SYNTAX IN STORAGE 

RESERVATION. 

The operand of a reserve storage instruction 
must be preresolved, absolute, positive arithme- 
tic expression. Only one operand is allowed. 

AS03061 INVALID SYNTAX IN DATA DEFINITION. 

The syntactical structure of the data definition 
operand is invalid. 
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LINE 
NUMBER 

nnnn 



nnnn 



nnnn 



nnnn 



ERROR 
TYPE 



nnnn 



nnnn 



W 



ERROR 
CODE 

AS03062 



AS03063 



AS03064 



AS03065 



AS03066 



AS03067 



MESSAGE TEXT 

INVALID USE OF INDIRECTION. 
An indirect operator is invalid in data 
definition operands. 

INVALID USE OF LITERAL. 

The literal operator is invalid in size or 

repetition field of a data definition operand. 

INVALID SIZE SPECIFICATION. 

The size operand of data definitions must 

be preresolved absolute expression. 

INVALID REPETITION FACTOR. 
The repetition factor of a data definition 
operand must be a preresolved absolute 
expression. 

VALUE OF LOCATION COUNTER 
EXCEEDS 65,535. 

TRUNCATION OCCURRED. 
The implied size of the value operand is 
greater than the explicit size operand in a 
data definition. 



NOTE: AS03068 through AS03069 are reserved for future use. 



nnnn 



nnnn 



nnnn 



nnnn 



nnnn 



AS03070 INVALID USE OF SSYSEG. 

The data following $SYSEG definition must 
be two bytes long, word aligned, and relocatable. 

AS03071 REQUIRED OPERAND ENTRY MISSING. 

This instruction requires an operand and none 
was supplied. 

AS03072 INVALID SUBLIST. 

The syntax indicates a suboperand, but the 
instruction does not allow suboperands. 

AS03073 INVALID USE OF LITERAL. 

The instruction does not allow a literal as an 
operand, but one was coded. 

AS03074 INVALID USE OF INDIRECTION. 

The instruction does not allow indirection, 
but indirection was coded. 
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LINE 
NUMBER 

nnnn 



ERROR 
TYPE 



ERROR 
CODE 

AS03075 



nnnn 



nnnn 



W 



W 



AS03076 
AS03077 



nnnn 



nnnn 



W 



nnnn 



nnnn 



nnnn 



W 



nnnn 



MESSAGE TEXT 

INVALID EXPRESSION. 

The expression coded does not fall within the 

types allowed. 

1 . A string type was used where only 
arithmetic type expressions are allowed. 

2. An unresolved expression was coded on 
an instruction which required expressions 
to be predefined. 

3. A relocatable expression is coded where 
only absolute are allowed. 

NAME FIELD OF ORG STATEMENT MAY 
ONLY CONTAIN A SEQUENCE SYMBOL. 

INVALID RELOCATION. 

1 . An absolute value was coded where a 
relocatable value was required. 

2. The relocation identifier does not 
match the relocation identifier for the 
control section in effect; e.g., trying to 
ORG to another CSECT or COM section. 



AS03078 NAME ENTRY REQUIRED ON AN EQU 

STATEMENT. 

AS03079 TOO MANY OPERANDS. 

More than the maximum number of operands 
allowable for this instruction were coded. The 
values of the first operands were used. 

AS03080 ONLY SINGLE TERM RELOCATABLE 

EXPRESSIONS ARE VALID. 

AS03081 COMBINED CSECT, COM AND EXTRN 

COUNT EXCEEDS 252. 
The binary generated will probably not be 
useless. Reduce the number of EXTERNs 
and CSECTs and COMs and reassemble. 

AS03082 INVALID NAME ENTRY. 

The name entry was coded where none was 
allowed. The name entry has not been entered 
into the symbol table. Any reference to it will 
result in an undefined reference. 

AS03083 REFERENCE TO INVALID FORM DEFINITION. 

1 . The operation entry matches something other 
than a FORM definition. 

2. There was no such entry. 

3. No operand was coded on the reference. 
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nnnn 



W 



ERROR 
CODE 

AS03084 



nnnn 


F 


AS03085 


nnnn 


F 


AS03086 


nnnn 


F 


AS03087 



AS03088 



MESSAGE TEXT 

OPERAND SIZE EXCEEDS 255 BITS. 
A FORM definition was coded with an operand 
which did not resolve to an absolute value less 
than 255. 

DUPLICATE DEFINITION OF NAME ENTRY. 

NAME ENTRY REQUIRED ON A FORM 
DEFINITION. 

CSECT NAME MAY NOT DUPLICATE COM 
NAME. 

The name entries of CSECT and COM state- 
ments cannot duplicate each other in the same 
assembly. 

ONLY ONE TITLE STATEMENT IN A 
PROGRAM MAY HAVE A NONBLANK 
NAME FIELD. 



nnnn 



AS03089 



nnnn 



nnnn 



nnnn 



nnnn 



nnnn 



nnnn 



AS04001 



AS04002 



AS04003 



AS04004 



AS04005 



AS04006 



INVALID PRIME ENTRY POINT. 

1 . The operand of an END statement does 
not resolve to an even boundary. 

2. The operand does not reference a 
relocatable value. 

INVALID FORM DEFINITION. 

A form reference cannot be used as an operand 

entry. 

INVALID USE OF $SYSEG. 

$SYSEG is invalid in an evaluated expression. 

RELOCATABLE TERM INVALID WITH 
UNARY OPERATOR. 
A relocatable term may not be used in 
conjunction with a NOT operator. 

INVALID USE OF STRING CONSTANT. 
A string constant may not be used as a term 
in conjunction with an arithmetic or logical 
operator. 

RELOCATABLE TERM INVALID WITH */ 
OR LOGICAL OPERATOR *. . .insert. . .* 
A relocatable term may not be used in conjunc- 
tion with a multiplication, division, or logical 
operation. 

INVALID SYNTAX. 

The operand structure does not follow the rules 

of the language. 
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INDEX 



Abort messages G-25 

Absolute 

expressions, definition of 2-1 7 

terms, definition of 2-4 

Addressing in machine instructions 3-2,3-3 

ADO statement 10-20 

AGO statement 10-23 

ALIGN statement 6-6 

Alignment 

of data 8-2 

of machine instructions 3-1 

Alphabetical list of machine 

instructions C-1 

AN OP statement 10-23 

Arithmetic 

constants 2-7 

operators 2-16 

set expressions 10-16 

Assembler instructions 

definition 1-1 

overview 4-1 

summary E-1 

Assembly options 1 1 -1 

BDD statement 8-2 
Begin-end columns 

alteration of 6-4 

description 2-18 

BRS statement 8-5 

Byte reserve storage 8-5 

Byte defined data 8-2 

Calling assembler 11-1 

Card codes A-1 
Character 

codes A-1 

set 2-1 

set expression 10-18 

string constants 2-5 



Coding form 

format of 2-18 

statement continuation 2-21 

COM statement 5-4 

Comments 2-20 

Common control sections (see 

COM statement) 

Conditional assembly statements 

ADO 10-20 

AGO 10-23 

ANOP 10-23 

GBLA 10-20 

GBLC 10-20 

SETA 10-16 

SETC 10-18 

Constants 

arithmetic 2-7 

string 2-5 

Continuation of statements 2-21 

Control language for assembler 11-1 

Control sections 

and location counter 2-1 1 

assembler statements for 5-1 

Count attribute of macro instruc- 
tion operand 10-24 

Cross reference list, suppressing 11-2 

CSECT statement 5-1 

Data definition statements 8-1 

Diagnostic messages G-1 

EBCDIC table A-1 

EJECT statement 9-2 

END statement 6-3 

ENTRY statement 5-2 

EQU statement 8-1 
Error messages 

abort messages G-25 

diagnostic messages G-1 

system messages G-26 



lndex-1 



Expressions 

absolute 2-17 

definition 2-14 

evaluation of 2-15 

relocatable 2-18 

Extended mnemonics 3-10 

EXTRN statement 5-3 

FORM definition statement 8-7 
FORM instruction statement 8-7 
G B LA statement 1 0-20 
GBLC statement 10-20 
General purpose machine instruc- 
tions 3-3,3-5 
Global arithmetic and character 

set symbols 10-20 

Hex codes of machine instruc- 



tions 


D-1 


Hexadecimal string constants 


2-6 


ICTL statement 


6-4 


Identification-sequence field 


2-20 


Index registers 


3-2,3-3 


Input format control 


6-4 


Integer string constants 


2-6 


ISEQ statement 


6-5 


Job control language (see 




Control language) 




Linkage editor 




and control sections 


5-1 


and symbol linkage 


5-2 


map directive (SEG) 


7-1 


Linking statements 


5-1,5-2 


Listing control statements 




EJECT 


9-2 


PRINT 


9-3 


SPACE 


9-2 


TITLE 


9-1 


Literal pools 




and LTORG statement 


6-4 


description 


2-13 


Literals 




description 


2-13 


in WDD and BDD statements 


8-3 



Location counter 

and ALIGN statement 6-6 

and ORG statement 6-1 
and WDD and BDD statements 8-4 

description 2-1 1 

reference (asterisk) 2-1 1 

Logical operators 2-16 

LTORG statement 6-4 

Machine instructions 

alphabetical list C-1 

definition 1-1 

hex code to mnemonic D-1 

object formats B-1 

summary 3-1 

Macro language 

concatenation of variable 

symbols 10-11 

count attribute 10-24 

example F-1 

file definition 11-1 

general description 10-1 

macro definition 10-1 

macro instruction 10-5 

MEXIT statement 10-13 

M NOTE statement 10-12 

nesting of macros 10-13 

number attribute 10-25 
sublists in macro instructions 10-9 

sublists in model statements 10-9 

substring notation 10-10 
system variable symbols 

(&SYSNDX,&SYSECT) 10-13 

Messages, error G-1 

Mnemonic definition (FORM) 8-7 

Name field, description 2-3 
Notation used to describe 

machine instructions 3-2 
Number attribute of macro 

instruction operand 10-25 

Object formats of machine instruc- 
tions B-1 

Object program 

definition 1-1 

file definition 11-1 
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Operand field, description 


2-3,2-20 


Source statements (continued) 




Operating system, relationship to 




terms 


2-3,2-4 


assembler 


1-2 


SPACE statement 


9-2 


Operation codes (hex) for 




String constants 




machine instructions 


D-1 


character 


2-5 


Operation field, description 


2-3,2-20 


hexadecimal 


2-6 


Operators 


2-16 


integer 


2-6 


Ordinary symbols 


2-9 


packed decimal 


2-6 


ORG statement 


6-1 


zoned decimal 


2-6 






Symbol definition statements 


8-1 


Packed decimal string constants 


2-6 


Symbol length attribute 


2-12 


PRINT statement 


9-3 


Symbolic linkage statements 


5-2 


Program 




Symbols 




control statements 


6-1 


definition 


2-8 


listing 


1-2,9-1 


ordinary 


2-9 


sectioning 


5-1 


rules for using 


2-9 


termination 


6-3 


sequence 


2-11 


PUNCH statement 


6-3 


variable 


2-10 


Registers 


3-2,3-3 


SYSEG reserved name 


5-6,8-3 


Relational operators 


2-16 


System 




Relocatable 




machine instructions 


3-3,3-9 


expressions, definition of 


2-18 


messages 


G-26 


symbols, identification of 


5-1,5-2 


requirements for assembler 


1-2 


terms, definition of 


2-4 


TITLE statement 


9-1 


Reserving storage 


8-5 


Termination of assembly 
Terms 


6-3 


SEG statement 


7-1 


constants 


2-5 


Segment names (see SYSEG) 




definition 


2-3,2-4 


Sequence checking statements 


6-5 


literals 


2-13 


Sequence symbols 


2-11 


location counter reference 


2-11 


Set symbols 


10-16 


symbols 


2-8 


SETA statement 


10-16 


symbol length attribute 


2-12 


SETC statement 


10-18 






Source program 




Variable symbols 


2-10 


definition 


1-1 






file definition 


11-1 


WDD statement 


8-2 


listing control 


9-1,11-2 


Word defined data 


8-2 


Source statements 




Word reserve storage 


8-5 


basic format 


2-3 


Writing to disk file 


6-3 


character set 


2-1 


WRS statement 


8-5 


coding form 


2-18 






expressions 


2-3,2-14 


Zoned decimal string constants 


2-6 
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